---
title: Spring boot MySQL连接超时
date: 2018-07-09 14:15:14
description: 风控项目每个月的定时任务发现了连接超时的问题，解决该问题的方法：修改数据库连接池的配置
categories: [技术总结]
tags: [Spring boot, MySQL, Tomcat]
---

## 错误场景
> 风控项目每个月都要执行定时任务计算大量数据，最近发现定时任务执行失败了，查了一下日志是数据库连接超时导致的，查阅资料后解决该问题

- Spring boot版本：`1.5.8.RELEASE`

### 错误信息
```log
The last packet successfully received from the server was 1,607,221,718 milliseconds ago.  
    The last packet sent successfully to the server was 1,607,221,719 milliseconds ago. 
    is longer than the server configured value of 'wait_timeout'. 
    You should consider either expiring and/or testing connection validity before use in your application, 
    increasing the server configured values for client timeouts, 
    or using the Connector/J connection property 'autoReconnect=true' to avoid this problem.
```

### 解决方法
> **注意：** 错误提示中说的`autoReconnect=true`配置只在低版本（MySQL1.5以下）数据库中适用

使用Spring boot数据源的连接池配置：
```properties
#验证连接的有效性
#获取连接时候验证，会影响性能
#空闲连接回收的时间间隔，与test-while-idle一起使用，设置5分钟
#连接池空闲连接的有效时间 ，设置30分钟
spring.datasource.prod.test-while-idle=true
#spring.datasource.prod.test-on-borrow=true
spring.datasource.prod.validation-query=SELECT 1 FROM DUAL
spring.datasource.prod.time-between-eviction-runs-millis=300000
spring.datasource.prod.min-evictable-idle-time-millis=1800000

spring.datasource.credit.test-while-idle=true
#spring.datasource.credit.test-on-borrow=true
spring.datasource.credit.validation-query=SELECT 1 FROM DUAL
spring.datasource.credit.time-between-eviction-runs-millis=300000
spring.datasource.credit.min-evictable-idle-time-millis=1800000
```
参照[官网多数据源配置](https://docs.spring.io/spring-boot/docs/1.5.8.RELEASE/reference/htmlsingle/#howto-two-datasources)

### Tomcat连接池详细配置

| 配置        | 说明          |
|:-------------|:------------------|
|spring.dao.exceptiontranslation.enabled | 是否开启PersistenceExceptionTranslationPostProcessor，默认为true |
|spring.datasource.abandon-when-percentage-full | 设定超时被废弃的连接占到多少比例时要被关闭或上报 |
|spring.datasource.allow-pool-suspension | 使用Hikari pool时，是否允许连接池暂停，默认为: false |
|spring.datasource.alternate-username-allowed | 是否允许替代的用户名. |
|spring.datasource.auto-commit | 指定updates是否自动提交. |
|spring.datasource.catalog | 指定默认的catalog. |
|spring.datasource.commit-on-return | 设置当连接被归还时，是否要提交所有还未完成的事务 |
|spring.datasource.connection-init-sql | 指定连接被创建，再被添加到连接池之前执行的sql. |
|spring.datasource.connection-init-sqls | 使用DBCP connection pool时，指定初始化时要执行的sql |
|spring.datasource.connection-properties.[key] | 在使用DBCP connection pool时指定要配置的属性 |
|spring.datasource.connection-test-query | 指定校验连接合法性执行的sql语句 |
|spring.datasource.connection-timeout | 指定连接的超时时间，毫秒单位. |
|spring.datasource.continue-on-error | 在初始化数据库时，遇到错误是否继续，默认false |
|spring.datasource.data | 指定Data (DML)脚本 |
|spring.datasource.data-source-class-name | 指定数据源的全限定名. |
|spring.datasource.data-source-jndi | 指定jndi的地址 |
|spring.datasource.data-source-properties.[key] | 使用Hikari connection pool时，指定要设置的属性 |
|spring.datasource.db-properties | 使用Tomcat connection pool，指定要设置的属性 |
|spring.datasource.default-auto-commit | 是否自动提交. |
|spring.datasource.default-catalog | 指定连接默认的catalog. |
|spring.datasource.default-read-only | 是否设置默认连接只读. |
|spring.datasource.default-transaction-isolation | 指定连接的事务的默认隔离级别. |
|spring.datasource.driver-class-name | 指定driver的类名，默认从jdbc url中自动探测. |
|spring.datasource.fair-queue | 是否采用FIFO返回连接. |
|spring.datasource.health-check-properties.[key] | 使用Hikari connection pool时，在心跳检查时传递的属性 |
|spring.datasource.idle-timeout | 指定连接多久没被使用时，被设置为空闲，默认为10ms |
|spring.datasource.ignore-exception-on-pre-load | 当初始化连接池时，是否忽略异常. |
|spring.datasource.init-sql | 当连接创建时，执行的sql |
|spring.datasource.initial-size | 指定启动连接池时，初始建立的连接数量 |
|spring.datasource.initialization-fail-fast | 当创建连接池时，没法创建指定最小连接数量是否抛异常 |
|spring.datasource.initialize | 指定初始化数据源，是否用data.sql来初始化，默认: true |
|spring.datasource.isolate-internal-queries | 指定内部查询是否要被隔离，默认为false |
|spring.datasource.jdbc-interceptors | 使用Tomcat connection pool时，指定jdbc拦截器，分号分隔 |
|spring.datasource.jdbc-url | 指定JDBC URL. |
|spring.datasource.jmx-enabled | 是否开启JMX，默认为: false |
|spring.datasource.jndi-name | 指定jndi的名称. |
|spring.datasource.leak-detection-threshold | 使用Hikari connection pool时，多少毫秒检测一次连接泄露. |
|spring.datasource.log-abandoned | 使用DBCP connection pool，是否追踪废弃statement或连接，默认为: false |
|spring.datasource.log-validation-errors | 当使用Tomcat connection pool是否打印校验错误. |
|spring.datasource.login-timeout | 指定连接数据库的超时时间. |
|spring.datasource.max-active | 指定连接池中最大的活跃连接数. |
|spring.datasource.max-age | 指定连接池中连接的最大年龄 |
|spring.datasource.max-idle | 指定连接池最大的空闲连接数量. |
|spring.datasource.max-lifetime | 指定连接池中连接的最大生存时间，毫秒单位. |
|spring.datasource.max-open-prepared-statements | 指定最大的打开的prepared statements数量. |
|spring.datasource.max-wait | 指定连接池等待连接返回的最大等待时间，毫秒单位. |
|spring.datasource.maximum-pool-size | 指定连接池最大的连接数，包括使用中的和空闲的连接. |
|spring.datasource.min-evictable-idle-time-millis | 指定一个空闲连接最少空闲多久后可被清除. |
|spring.datasource.min-idle | 指定必须保持连接的最小值(For DBCP and Tomcat connection pools) |
|spring.datasource.minimum-idle | 指定连接维护的最小空闲连接数，当使用HikariCP时指定. |
|spring.datasource.name | 指定数据源名. |
|spring.datasource.num-tests-per-eviction-run | 指定运行每个idle object evictor线程时的对象数量 |
|spring.datasource.password | 指定数据库密码. |
|spring.datasource.platform | 指定schema要使用的Platform(schema-${platform}.sql)，默认为: all |
|spring.datasource.pool-name | 指定连接池名字. |
|spring.datasource.pool-prepared-statements | 指定是否池化statements. |
|spring.datasource.propagate-interrupt-state | 在等待连接时，如果线程被中断，是否传播中断状态. |
|spring.datasource.read-only | 当使用Hikari connection pool时，是否标记数据源只读 |
|spring.datasource.register-mbeans | 指定Hikari connection pool是否注册JMX MBeans. |
|spring.datasource.remove-abandoned | 指定当连接超过废弃超时时间时，是否立刻删除该连接. |
|spring.datasource.remove-abandoned-timeout | 指定连接应该被废弃的时间. |
|spring.datasource.rollback-on-return | 在归还连接时，是否回滚等待中的事务. |
|spring.datasource.schema | 指定Schema (DDL)脚本. |
|spring.datasource.separator | 指定初始化脚本的语句分隔符，默认: ; |
|spring.datasource.sql-script-encoding | 指定SQL scripts编码. |
|spring.datasource.suspect-timeout | 指定打印废弃连接前的超时时间. |
|spring.datasource.test-on-borrow | 当从连接池借用连接时，是否测试该连接. |
|spring.datasource.test-on-connect | 创建时，是否测试连接 |
|spring.datasource.test-on-return | 在连接归还到连接池时是否测试该连接. |
|spring.datasource.test-while-idle | 当连接空闲时，是否执行连接测试. |
|spring.datasource.time-between-eviction-runs-millis | 指定空闲连接检查、废弃连接清理、空闲连接池大小调整之间的操作时间间隔 |
|spring.datasource.transaction-isolation | 指定事务隔离级别，使用Hikari connection pool时指定 |
|spring.datasource.url | 指定JDBC URL. |
|spring.datasource.use-disposable-connection-facade | 是否对连接进行包装，防止连接关闭之后被使用. |
|spring.datasource.use-equals | 比较方法名时是否使用String.equals()替换==. |
|spring.datasource.use-lock | 是否对连接操作加锁 |
|spring.datasource.username | 指定数据库名. |
|spring.datasource.validation-interval | 指定多少ms执行一次连接校验. |
|spring.datasource.validation-query | 指定获取连接时连接校验的sql查询语句. |
|spring.datasource.validation-query-timeout | 指定连接校验查询的超时时间. |
|spring.datasource.validation-timeout | 设定连接校验的超时时间，当使用Hikari connection pool时指定 |
|spring.datasource.validator-class-name | 用来测试查询的validator全限定名. |
|spring.datasource.xa.data-source-class-name | 指定数据源的全限定名. |
|spring.datasource.xa.properties | 指定传递给XA data source的属性 |

> 参照:
> [Tomcat官网配置](https://tomcat.apache.org/tomcat-8.0-doc/jdbc-pool.html#Common_Attributes)
> [转载博文](https://segmentfault.com/a/1190000004316491)