max-lifetime的核心目标是让归还池中的连接在被再次使用前有机会被主动清理，防止因数据库wait_timeout或网络中断导致“假活”；它仅在连接归还池后生效，不干预正在使用的连接，推荐值应比数据库wait_timeout短并留安全余量，如MySQL默认28800秒时设为1800000毫秒（30分钟），需与idle-timeout协同使用。
设置 max-lifetime 的核心目标不是“避免空闲断开”，而是让连接在被归还到池中后、尚未被再次使用前，有机会被主动清理——防止它因数据库侧超时（如 MySQL 的 wait_timeout）或网络中断而变成“假活”连接。
max-lifetime 的真实作用机制
这个参数只在连接归还到池中之后才生效。只要连接被应用持有（即调用 getConnection() 后未调用 close()），无论过了多久，max-lifetime 都不会触发。它不干预正在使用的连接，也不等同于 TCP keepalive 或数据库会话超时。
- 连接归还池中 → 进入空闲队列 → 池开始倒计时其“已存活时长”
- 若该连接在池中空闲期间，其总存活时间（从创建起算）超过
max-lifetime，下次被借出前会被静默丢弃并重建 - 因此它解决的是“长期闲置但未释放的连接可能失效”的问题，而非“连接中途断开”
推荐值与数据库超时的配合
必须比数据库服务端的连接空闲超时短，留出安全余量。以 MySQL 默认 wait_timeout = 28800 秒（8 小时） 为例：
- 推荐
max-lifetime = 1800000 毫秒（30 分钟） - 这是生产环境最广泛验证的值，兼顾稳定性与连接复用率
- 若你调高了 MySQL 的
wait_timeout（比如设为 7200 秒），可相应上调至6000000 毫秒（100 分钟），但仍建议保留至少 30 秒缓冲
配合 idle-timeout 才能覆盖“纯空闲”场景
max-lifetime 不负责清理“刚空闲几秒就该淘汰”的连接；那是 idle-timeout 的职责：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
-
idle-timeout：连接在池中空闲超过该时间，且当前连接数 >minimum-idle，就关闭它 - 典型值：600000 毫秒（10 分钟）
- 两者协同：
idle-timeout主动瘦身空闲池，max-lifetime保底兜底老化连接
Spring Boot 中的正确配置方式
直接在 application.yml 中设置，无需额外代码：
spring:
datasource:
hikari:
max-lifetime: 1800000
idle-timeout: 600000
connection-timeout: 30000
minimum-idle: 5
maximum-pool-size: 20
注意：max-lifetime 单位是毫秒；若设为 0，表示禁用该检查（不推荐）；负值无效。
