1. 理解 MySQL 连接超时在 Spring Boot 场景中的作用
1.1 关键概念与时序
在 Spring Boot 使用的典型场景中，数据库连接超时与连接池超时是两个层面的概念。连接超时通常指应用向数据库请求建立新连接时的等待时长，一旦超过设定就抛出异常；而连接池超时（例如 HikariCP 的 connectionTimeout）决定了从池中获取一个连接的最大等待时间。理解这两者之间的区分对定位问题和选择参数十分关键。
在高并发场景下，连接池需要快速分发连接以避免阻塞请求，如果没有合理的超时配置，短时波动也可能导致连接耗尽、队列排队，进而影响业务响应时间。另一方面，若数据库端存在长时间空闲连接，过多的闲置连接会浪费资源并增加数据库端的负载。
2. 在 Spring Boot 中定位并修改连接超时相关参数
2.1 配置源的定位与优先级
Spring Boot 的配置来源包括 application.properties、application.yml、环境变量和命令行参数，并且存在配置属性的层级优先级。了解这一点有助于在各种部署环境中快速覆盖默认值。
常见做法是将连接超时相关参数放在应用的配置中心中，以便与数据库信息、环境变量、部署阶段解耦。对于 Spring Boot 使用的 HikariCP 池，配置项通常以 spring.datasource.hikari. 开头，便于区分。
3. MySQL 端的超时设置及其影响
3.1 wait_timeout 与 interactive_timeout 的作用
MySQL 服务器有两类超时控制：wait_timeout（非交互式连接的空闲超时）和 interactive_timeout（交互式连接的空闲超时）。这两个值决定了服务器在多长时间后将闲置连接关闭，这会影响应用从连接池中获取连接后的可用性。
默认值往往较长，例如 wait_timeout 28800 秒（8 小时），这在开发环境看起来没问题，但在容器化和水平扩展的生产环境中，未及时同步调整会导致“连接被数据库服务器端关闭”的错误，进而触发连接重试或应用异常。
4. 逐步示例：在 application.properties 配置
4.1 示例配置（properties 语法）
下面给出一个典型的 Spring Boot + MySQL 的配置样例，聚焦于连接超时和连接池参数。注意将数据库地址、账号和密码替换为实际环境的值。
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/mydb?serverTimezone=UTC&useUnicode=true&characterEncoding=UTF-8
spring.datasource.username=root
spring.datasource.password=secret
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver# HikariCP 相关
spring.datasource.hikari.connection-timeout=30000 # 连接池取出连接的超时（毫秒）
spring.datasource.hikari.maximum-pool-size=50 # 连接池最大连接数
spring.datasource.hikari.minimum-idle=10 # 最小空闲连接数
spring.datasource.hikari.idle-timeout=600000 # 空闲连接超时（毫秒）
spring.datasource.hikari.max-lifetime=1800000 # 连接在池中的最大寿命（毫秒）
spring.datasource.hikari.connection-test-query=SELECT 1 # 测试连接有效性的 SQL
4.2 示例配置（yaml 语法）
若使用 application.yml，等价配置如下，层级关系要保持正确：
spring:datasource:url: jdbc:mysql://127.0.0.1:3306/mydb?serverTimezone=UTC&useUnicode=true&characterEncoding=UTF-8username: rootpassword: secretdriver-class-name: com.mysql.cj.jdbc.Driverhikari:connection-timeout: 30000maximum-pool-size: 50minimum-idle: 10idle-timeout: 600000max-lifetime: 1800000connection-test-query: SELECT 1
5. 最佳实践与性能优化
5.1 与数据库端超时的协同配置
为了避免数据库端在长时间未用连接上产生超时，建议同步调整 MySQL 的 wait_timeout 和 interactive_timeout，以避免应用在获取连接时遇到“连接被关闭”的情况。值的设置应结合应用的连接获取速度和并发水平来取舍。
在高并发场景中，将最大连接数、空闲连接数以及连接最大寿命设定为合理水平，可以减少连接创建和销毁的开销，同时避免连接长期占用资源导致的瓶颈。
6. 常见问题排查与调试技巧
6.1 排查步骤与诊断方法
当应用出现连接超时相关异常时，首先需要确认错误信息中的异常类型、是来自获取连接还是从池中取出连接。接着检查 Spring Boot 的日志级别，确保可以看到连接尝试、超时发生的时间点以及堆栈信息。
常见排查项包括：数据库端 wait_timeout、应用端 hikari.connection-timeout、以及应用日志中的连接池警告。必要时可以临时开启连接测试查询，以确保连接在被分配给应用后能立即被验证通过。
-- 查看当前 MySQL 服务端超时设置
SHOW VARIABLES LIKE 'wait_timeout';
SHOW VARIABLES LIKE 'interactive_timeout';-- 如需临时调整（会话级别，谨慎操作）
SET GLOBAL wait_timeout = 600;
SET GLOBAL interactive_timeout = 600;
# 诊断性配置（示例）
spring.datasource.hikari.connection-timeout=20000
spring.datasource.hikari.maximum-pool-size=40
spring.datasource.hikari.idle-timeout=300000
spring.datasource.hikari.max-lifetime=1200000
spring:datasource:url: jdbc:mysql://db-host:3306/mydb?serverTimezone=UTCusername: userpassword: passhikari:connection-timeout: 20000maximum-pool-size: 40idle-timeout: 300000max-lifetime: 1200000
