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 小时） 为例：

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

• 推荐 max-lifetime = 1800000 毫秒（30 分钟）
• 这是生产环境最广泛验证的值，兼顾稳定性与连接复用率
• 若你调高了 MySQL 的 wait_timeout（比如设为 7200 秒），可相应上调至 6000000 毫秒（100 分钟），但仍建议保留至少 30 秒缓冲

配合 idle-timeout 才能覆盖“纯空闲”场景

max-lifetime 不负责清理“刚空闲几秒就该淘汰”的连接；那是 idle-timeout 的职责：

• 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，表示禁用该检查（不推荐）；负值无效。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南