Spring Boot 3 默认使用 HikariCP，连接 Oracle 21c/19c 必须配置 ojdbc11 驱动、正确 JDBC URL（含 EZCONNECT 格式、时区及 PDB 名精确匹配），并强制设置 max-lifetime（1800000ms）、connection-timeout（20000ms）和 idle-timeout（600000ms），否则易因“假活”连接或首次建连超时导致 Connection is not available 错误。
Spring Boot 3 默认用 HikariCP，连 Oracle 21c 或 19c 只需配对 JDBC 驱动 + URL + 关键超时参数，其余可不配；但若跳过 max-lifetime 和 connection-timeout，首次启动或网络抖动时大概率报 Connection is not available, request timed out after 30000ms。
确认 ojdbc11 依赖是否就位
Oracle 官方推荐 JDBC 驱动版本必须匹配数据库大版本：Oracle 21c / 19c 对应 ojdbc11（非 ojdbc8），否则可能触发隐式类型转换失败、LOB 读取异常或连接静默中断。
- 检查
pom.xml中是否显式引入了ojdbc11，且未被其他 starter 的传递依赖覆盖（如旧版spring-boot-starter-data-jpa可能带ojdbc8） - 若存在冲突，用
<exclusions></exclusions>排除旧驱动：<exclusion> <groupId>com.oracle.database.jdbc</groupId> <artifactId>ojdbc8</artifactId> </exclusion>
- Maven 坐标应为：
com.oracle.database.jdbc:ojdbc11:23.6.0.24.07（截至 2026 年 9 月最新稳定版）
application.yml 中必须设的三项参数
HikariCP 在 Oracle 场景下对连接生命周期非常敏感，max-lifetime 必须小于 Oracle 的 sqlnet.ora 中 SQLNET.EXPIRE_TIME（默认 0，即不探测）或数据库级 wait_timeout（Oracle 实际由 INACTIVE_SESSION_LIMIT 或 RAC FCF 控制）。跳过配置极易导致连接池中“假活”连接在后台被 Oracle 主动断开，后续请求复用时报 IO Error: Connection reset。
-
spring.datasource.hikari.max-lifetime: 1800000（30 分钟，比 Oracle 默认连接保活窗口保守留出 5–10 分钟余量） -
spring.datasource.hikari.connection-timeout: 20000（20 秒，避免首次建连因 DNS 解析/防火墙策略慢而超时失败） -
spring.datasource.hikari.idle-timeout: 600000（10 分钟，与max-lifetime错开，防止空闲连接刚淘汰完又触发重建风暴）
Oracle 特有 URL 参数不能漏
Oracle JDBC URL 若缺少关键参数，会导致连接成功但执行 SQL 时抛 ORA-00911: invalid character（因分号自动补全）、ORA-01882: timezone region not found（时区未声明）或 ORA-17002: Io exception: The Network Adapter could not establish the connection（TNS 解析失败）。
- 强制指定时区：
?oracle.timezoneAsRegion=false&serverTimezone=Asia/Shanghai - 关闭自动 commit 检测（Oracle 不支持标准 JDBC autocommit 模式）：
&defaultRowPrefetch=100&implicitStatementCacheSize=25 - TNS 连接建议用 EZCONNECT 格式，避免本地
tnsnames.ora依赖：jdbc:oracle:thin:@//host:1521/ORCLPDB1（注意双斜杠和 PDB 名）
为什么不要配 connection-test-query
HikariCP 默认调用 Connection.isValid() 做连接存活检测，而 Oracle 21c+ 的 ojdbc11 已完整实现该接口；手动配 connection-test-query: SELECT 1 FROM DUAL 反而会增加单次获取连接的 RT，并在高并发下引发大量无意义的 DUAL 查询，占用 shared pool latch。
- 仅当使用极老 Oracle（如 11g）+
ojdbc6时才考虑启用该参数 - 生产环境一律删掉该配置项，让 HikariCP 走原生
isValid() - 若仍怀疑连接有效性，改用
spring.datasource.hikari.keepalive-time: 300000（5 分钟 ping 一次，只作用于空闲连接）
真正容易被忽略的是 Oracle 的 PDB 名是否拼写精确、大小写是否匹配——ORCLPDB1 和 orclpdb1 在某些 Oracle 配置下会被视为不同服务名，此时连接池会反复尝试建连并超时，日志里只显示模糊的 Connection refused，而不是明确的 TNS 错误。
