oracle主备库连接必须用tns别名或scan,禁止单节点jdbc url硬编码ip;jdbc thin驱动不支持自动故障转移,需依赖oracle客户端层路由,且tnsnames.ora中必须配置failover=on、load_balance=on及完整failover_mode。

Oracle主备库连接必须用TNS或SCAN,不能只写单节点URL
直接在jdbc:oracle:thin:@//host:port/service_name里填一个IP,永远连不上主备切换后的备库——JDBC Thin驱动本身不支持自动故障转移。你得让Oracle客户端层(即JDBC驱动背后的网络栈)来接管路由。
常见错误现象:Io exception: Connection refused 或反复连到已宕机的主库、查不到数据但无报错;本质是连接发到了下线节点,而驱动没做重试或重定向。
- 必须用TNS别名方式:URL写成
jdbc:oracle:thin:@MYDB,再配tnsnames.ora - 或直接用SCAN地址(RAC环境):URL为
jdbc:oracle:thin:@sales.example.com:1521/sales_service,前提是DNS能解析SCAN名且监听正常 - 不要试图在URL里拼多个host——Thin驱动不识别逗号分隔或括号语法,那属于TNS描述符范畴
tnsnames.ora里要声明FAILOVER和LOAD_BALANCE
光有多个地址不够,没开FAILOVER=ON,驱动连第一个失败就抛异常,根本不会试第二个;没开LOAD_BALANCE=on,所有连接都打到第一个地址上,备库闲着。
典型配置片段(保存为$ORACLE_HOME/network/admin/tnsnames.ora或任意路径,通过-Doracle.net.tns_admin=/path/to/tns指定):
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
MYDB =
(DESCRIPTION =
(ADDRESS_LIST =
(LOAD_BALANCE = on)
(FAILOVER = on)
(ADDRESS = (PROTOCOL = tcp)(HOST = primary-db)(PORT = 1521))
(ADDRESS = (PROTOCOL = tcp)(HOST = standby-db)(PORT = 1521))
)
(CONNECT_DATA =
(SERVICE_NAME = orclpdb1)
(FAILOVER_MODE =
(TYPE = SELECT)
(METHOD = BASIC)
(RETRIES = 3)
(DELAY = 5)
)
)
)
-
TYPE = SELECT表示只对只读查询启用透明故障转移(避免事务中断) -
RETRIES和DELAY控制重试节奏,别设太大,否则应用感知延迟高 - 确保
SERVICE_NAME在主备库上一致(查SELECT value FROM v$parameter WHERE name = 'service_names'确认)
Java端必须禁用连接池的“健康检查绕过”行为
HikariCP等连接池默认会缓存连接、跳过每次获取时的可用性检测。主库切走后,池里大量“僵尸连接”还在被复用,导致SQLException: Closed Connection或查询超时。
- 设
connection-test-query=SELECT 1 FROM DUAL(Oracle专用探活语句) - 开
connection-timeout=3000,避免卡死线程 - 关
cache-prep-stmts=false——预编译语句缓存在主库上下文,切到备库可能失效 - 别设
max-lifetime过长(建议≤1800000ms),强制定期重建连接以适应服务名映射变化
密码和字符集参数不能依赖URL query string硬编码
主备库账号密码必须完全一致,且不能靠URL里的?user=xxx&password=yyy传——这违反Oracle官方安全要求,也容易在日志/监控中泄露;字符集若只靠useUnicode=true&characterEncoding=UTF-8,在ojdbc8+里实际无效。
- 用户名密码必须通过
DataSource的setUsername()/setPassword()方法传入,或由连接池统一管理 - 真正生效的字符集靠数据库端配置(
ALTER DATABASE CHARACTER SET AL32UTF8),JDBC层无需额外参数 - 主备库必须用相同字符集,否则切换后中文变乱码,且无法通过JDBC参数修复
最易被忽略的一点:TNS配置文件路径和Java启动参数必须严格匹配——-Doracle.net.tns_admin 指向的目录下必须有tnsnames.ora,且文件权限不能是777(Oracle驱动会拒绝加载),Linux下建议644,Windows下确保Java进程有读取权限。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










