Oracle空闲连接被切断主因是数据库端IDLE_TIME配置，非Java代码问题；需先查DBA_PROFILES确认限制值，再配合HikariCP的keepalive-time、validation-timeout等参数协同防御，且修改后必须重建连接池才生效。
Oracle空闲连接被切断，90%不是Java代码问题，而是数据库端IDLE_TIME主动踢人。 默认值是10分钟（600秒），超时后Oracle直接关闭socket，应用再用该连接就会抛ORA-03135或IO Error: Broken pipe。光调Java参数不查DBA_PROFILES，等于在断连边缘反复横跳。
先确认Oracle端IDLE_TIME限制值
别急着改HikariCP配置，登录Oracle用DBA账号执行：
SELECT resource_name, limit FROM dba_profiles WHERE profile = 'DEFAULT' AND resource_name = 'IDLE_TIME';
返回UNLIMITED说明不是它；如果是数字（比如30），那就是根源——单位是分钟，对应1800000毫秒。修改后旧连接仍按原值计时，必须重建连接池才生效。
- 临时方案：
ALTER USER app_user PROFILE DEFAULT;（重置为默认profile，通常IDLE_TIME=UNLIMITED） - 长期方案：
ALTER PROFILE DEFAULT LIMIT IDLE_TIME 60;（设为60分钟，或根据业务容忍度调整） - 注意：若用户指定了非DEFAULT profile，得查
DBA_USERS.PROFILE再改对应profile
HikariCP keepalive-time必须对齐IDLE_TIME
keepalive-time不是心跳频率，而是“空闲连接存活多久后触发一次有效性验证”，只对minimum-idle > 0的连接生效，且仅HikariCP v4.0.3+支持。它必须比Oracle的IDLE_TIME小至少2分钟，否则验证还没发出去，连接已被服务端销毁。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 若Oracle
IDLE_TIME = 30（1800000ms），建议设keepalive-time=1500000（25分钟） -
minimum-idle不能为0，否则没空闲连接可保活；建议设为5～10 -
validation-timeout必须≤connection-timeout，推荐3000（3秒），太短会误判健康连接
connection-init-sql和validation-query别混用
connection-test-query在HikariCP 5.0+已彻底废弃，硬写进去无效。正确姿势是组合使用connection-init-sql + validation-timeout，且Oracle必须用DUAL表：
-
connection-init-sql=SELECT 1 FROM DUAL（轻量、稳定、绕过NLS影响） - 避免
SELECT SYSDATE FROM DUAL——可能因时区/NLS设置失败 - 禁用
test-on-borrow，它会让每次取连接都阻塞验证，放大延迟；keepalive + init-sql更平滑 - Oracle JDBC驱动需支持
isValid()，ojdbc8（19c+）没问题，老ojdbc6可能静默失效
连接池重建和驱动版本常被忽略
Oracle端IDLE_TIME修改后，旧连接池里的连接仍按原超时倒计时，不会自动刷新。必须触发连接池重建——常见做法是重启应用，或调用HikariDataSource.close()后再新建实例。
- JDBC URL必须用service name格式：
jdbc:oracle:thin:@//host:port/SERVICE_NAME，别用SID（容器/PDB环境下大概率失效） - Maven中务必排除传递依赖的
ojdbc6：com.oracle ojdbc6 - 驱动类名必须显式指定：
driver-class-name=oracle.jdbc.driver.OracleDriver（HikariCP 5+已弃用自动推导）
最易被忽略的一点：所有参数调完，不重建连接池就等于白配。IDLE_TIME是服务端硬限制，Java侧只是配合防御，没有“覆盖”能力。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
