Java 17 + Oracle 19c 下 HikariCP 连接问题主因是驱动错配（必须用 ojdbc8）、URL 格式错误（须用 service name 而非 SID）、池参数超限（maximumPoolSize 需 ≤ processes×0.7÷实例数）、idleTimeout/maxLifetime 未适配 sqlnet.expire_time（应设为 9/25 分钟）及验证查询缺失（需设 SELECT 1 FROM DUAL）。
Java 17 + Oracle 19c 下，HikariCP 本身不是瓶颈，错配驱动、URL、池参数或 Oracle 服务端配置才会导致连接卡死、超时堆积、ORA-12516 或静默泄漏。
ojdbc8 驱动必须显式声明且排除旧版本
Java 17 不支持 ojdbc7，ojdbc8（如 com.oracle.database.jdbc:ojdbc8:21.10.0.0 或更高）是唯一兼容选择。Maven 中若存在传递依赖的 ojdbc6，必须显式排除：
<exclusion> <groupId>com.oracle</groupId> <artifactId>ojdbc6</artifactId> </exclusion>
同时，HikariConfig 中必须设 driver-class-name=oracle.jdbc.OracleDriver（注意不是 oracle.jdbc.driver.OracleDriver，后者在 HikariCP 5+ 已弃用，否则初始化失败并报 Unable to load class: oracle.jdbc.driver.OracleDriver）。
漏掉 --add-opens 启动参数也会触发反射限制异常，尤其在模块化环境下，需加：
立即学习“Java免费学习笔记（深入）”；
--add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.math=ALL-UNNAMED
URL 必须用 service name 格式，不能用 SID
Oracle 19c 默认启用多租户（CDB/PDB），jdbc:oracle:thin:@host:port:sid 在容器化或 PDB 环境下大概率失败，表现为 ORA-12514: TNS:listener does not currently know of service requested。
正确写法是双斜杠 + service name：
jdbc:oracle:thin:@//localhost:1521/ORCLPDB1
若用 TNSNAMES，则需设置 TNS_ADMIN 环境变量指向含 tnsnames.ora 的目录，并用 jdbc:oracle:thin:@MYDB；否则连接会卡在 DNS 解析或监听器路由阶段。
- 验证 service name 是否有效：登录数据库执行
SELECT value FROM v$parameter WHERE name = 'service_names'; - 避免在 URL 中拼接
?useServerPrepStmts=true—— Oracle 不支持服务端预编译，设为true会静默降级并抛 warning，干扰连接稳定性
maximumPoolSize 必须小于 Oracle processes × 0.7 ÷ 实例数
Oracle 的 processes 是全局硬上限（含后台进程、RMAN、SQL*Plus），默认值常为 300，但实际留给应用的通常仅 200–250。若单实例设 maximumPoolSize=50，而你有 4 个微服务实例，总连接数可能冲到 200+，叠加 DBA 维护操作极易触发 ORA-00020（max number of processes exceeded）或 ORA-12516（TNS:listener could not find available handler）。
推荐计算方式：
- 查数据库当前限制：
SELECT * FROM v$resource_limit WHERE resource_name = 'processes'; - 单实例安全值：
maximumPoolSize = min(50, (processes × 0.7) ÷ 实例数) -
minimum-idle建议与maximum-pool-size相同，避免冷启动连接重建延迟
别信 “CPU 核数 × 2” 公式——Oracle 连接开销远高于 MySQL，该公式在此场景下普遍偏高且无依据。
idleTimeout 和 maxLifetime 必须绕开 sqlnet.expire_time
Oracle 19c 默认启用死连接检测：sqlnet.expire_time=10（单位分钟），即空闲 10 分钟的 TCP 连接会被数据库主动断开。若 HikariCP 的 idleTimeout 或 maxLifetime 大于 600000ms（10 分钟），连接会在数据库侧被悄无声息地 kill，而连接池仍认为它可用，后续使用直接抛 java.sql.SQLRecoverableException: IO Error: Connection reset。
正确做法：
-
idleTimeout设为540000（9 分钟），留出缓冲窗口 -
maxLifetime设为1500000（25 分钟），确保在sqlnet.expire_time × 2.5内强制刷新 -
connection-test-query必须设为SELECT 1 FROM DUAL（Oracle 不支持isValid()默认检测） -
validation-timeout必须 ≤connection-timeout（建议 3000ms），否则验证失败不触发重连
隐式语句缓存也得对齐：implicitCachingEnabled=true + statementCacheSize=50，禁用 useServerPrepStmts，否则 Oracle 驱动层和 HikariCP 层缓存冲突，反而增加内存压力和连接不稳定风险。
