Spring Boot中MySQL的connectTimeout参数异常问题排查

你遇到的核心问题是参考文档版本与使用的驱动版本不匹配，导致对参数行为的理解出现偏差，以下是具体解析：

版本差异带来的参数行为不同 #

你使用的是MySQL Connector/J 5.1.46，但参考的是8.0版本的官方文档。两个版本中connectTimeout的作用范围存在明显区别：

• 8.0版本文档中，connectTimeout管控整个数据库连接建立的全流程（包括TCP连接、握手、认证等所有步骤），单位为毫秒
• 5.1.46版本中，connectTimeout仅作用于TCP连接建立阶段，后续的握手、认证等步骤耗时不受该参数限制，单位同样为毫秒

你的测试现象原因 #

你测试的本地连接耗时1400ms是全流程时间，当设置connectTimeout=10时，TCP连接本身在10ms内就已完成，后续握手认证的耗时不会触发该超时，因此无异常抛出；只有设置connectTimeout=1时，TCP连接建立无法在1ms内完成，才会触发超时异常。

5.1.46版本的正确超时配置方案 #

若要管控整个数据库连接流程的总耗时，需同时配置connectTimeout和socketTimeout两个参数：

• connectTimeout：限制TCP连接建立的超时时间（毫秒）
• socketTimeout：限制连接建立后，与服务器通信（握手、认证等）的读写超时时间（毫秒）

示例配置：

datasource.jdbc-url=jdbc:mysql://XX.XX.XX.XX/dbName?connectTimeout=5000&socketTimeout=5000

验证建议 #

可通过网络工具模拟数据库服务器高延迟环境，分别测试：

• 设置connectTimeout=1000，模拟TCP连接耗时超1000ms，验证是否触发超时
• 设置socketTimeout=1000，模拟TCP连接成功但握手认证耗时超1000ms，验证是否触发超时

内容的提问来源于stack exchange，提问作者Santanu Das