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 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
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进程有读取权限。
