必须分层设置超时:connection-timeout仅控制获取连接等待时间(默认30秒),不约束SQL执行;@Transactional(timeout)依赖驱动中断响应,易失效;最可靠的是statement-level timeout(如MyBatis timeout或setQueryTimeout),配合数据库端wait_timeout和innodb_lock_wait_timeout协同生效。

必须分层设置超时,只配 connection-timeout 没用,它管不了 SQL 执行时间。
connection-timeout 只控制“拿连接”这一步
这是 HikariCP 的 spring.datasource.hikari.connection-timeout,默认 30 秒。它只决定:应用从连接池里取一个空闲连接,最多等多久。一旦拿到连接,后续所有操作——包括执行一条卡死的 UPDATE、锁住 5 分钟的事务——它完全不管。
常见错误现象:
- 日志里报
Connection is not available, request timed out after 30000ms,但数据库里其实有大量Running状态的长事务 - 服务看起来“连不上库”,其实是连接池被占满,新请求全在排队等连接
所以它解决的是连接获取阻塞,不是 SQL 执行阻塞。
@Transactional(timeout=) 是最常用也最容易失效的一层
Spring 的 @Transactional(timeout = 10) 表示事务总耗时超过 10 秒就回滚。但它依赖底层 JDBC 驱动是否真正响应中断 —— 而 MySQL 驱动在某些场景下会忽略中断信号,尤其是网络卡顿或锁等待时。
使用前提和限制:
- 必须配合
spring.datasource.hikari.leak-detection-threshold一起用,否则连接泄漏后 timeout 不生效 - MySQL 需启用
wait_timeout和interactive_timeout(建议设为 60~300 秒),否则连接空闲超时会先断开 - 不能替代 SQL 级别的超时,比如一条没加
WHERE的UPDATE卡在行锁上,@Transactional可能根本等不到锁释放就超时了,但锁还在
真正管用的是 statement-level timeout
这一层直接作用于单条 SQL,由 JDBC 驱动传递给 MySQL Server,强制中止执行。优先级最高,也最可靠。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
三种主流方式:
- MyBatis-Plus:
mybatis-plus.configuration.default-statement-timeout=5(单位秒) - MyBatis XML:
<select id="xxx" timeout="5"></select>或<update timeout="5"></update> - JDBC 原生:
statement.setQueryTimeout(5),需在代码里显式调用
注意点:
- MySQL 8.0+ 对
setQueryTimeout支持更稳定;5.7 及更早版本在锁等待场景下可能延迟生效 - 该 timeout 会触发
java.sql.SQLTimeoutException,必须捕获并确保事务能正确回滚(Spring 默认会) - 值不宜设得太小,比如高频查询设 1 秒,批量更新可设 30 秒,要匹配业务 SLA
别忘了数据库端的 wait_timeout 和 innodb_lock_wait_timeout
这些是兜底防线,防止应用层超时失效后,事务还在数据库里挂着。
关键参数:
-
wait_timeout:控制空闲连接自动断开时间(单位秒),建议设为 60~300 -
innodb_lock_wait_timeout:控制行锁等待最大时长,默认 50 秒,建议调低到 10~25 秒,避免一个锁等待拖垮整个事务链 -
max_execution_time(MySQL 5.7.8+):可对单条 SELECT 强制设上限,如SELECT /*+ MAX_EXECUTION_TIME(1000) */ * FROM orders
修改方式:
SET GLOBAL wait_timeout = 120; SET GLOBAL innodb_lock_wait_timeout = 15;
这类参数必须在 MySQL 启动配置中固化,否则重启丢失;线上修改后建议用 SHOW VARIABLES LIKE '%timeout%' 核对。
最容易被忽略的是:statement timeout 和 innodb_lock_wait_timeout 的协同。前者在应用线程侧中断,后者在引擎层强制释放锁。两者都得设,且后者应略小于前者,才能确保锁不残留。

















