Grails中MySQL的maxWait配置未生效问题排查

核心问题是你混淆了HikariCP与Tomcat JDBC连接池的参数命名规则，导致配置的maxWait未被Hikari识别，系统始终使用Hikari默认的30秒连接超时（30000ms）。

原因说明 #

你在数据源中指定了type = "com.zaxxer.hikari.HikariDataSource"，但配置的maxActive、maxIdle、maxWait都是Tomcat JDBC连接池的参数名，HikariCP并不识别这些参数，因此会忽略你的自定义配置，沿用自身默认值（其中connectionTimeout默认就是30000ms，对应报错中的超时时间）。

解决步骤 #

1. 替换为HikariCP原生参数 #

将配置中的Tomcat风格参数替换为HikariCP的对应参数，以下是修正后的配置示例：

dataSource {
    pooled = true
    dbCreate = "none"
    url = "jdbc:mysql://localhost:3306/dev2?useUnicode=yes&characterEncoding=UTF-8"
    driverClassName = "com.mysql.cj.jdbc.Driver"
    dialect = org.hibernate.dialect.MySQL8Dialect
    type = "com.zaxxer.hikari.HikariDataSource"
    properties {
        jmxEnabled = true
        // HikariCP 核心参数替换
        maximumPoolSize = 50    // 对应原maxActive：连接池最大连接数
        minimumIdle = 5         // 对应原minIdle：连接池最小空闲连接数
        connectionTimeout = 10000 // 对应原maxWait：获取连接超时时间（毫秒）
        maxLifetime = 10 * 60000 // 对应原maxAge：连接最大存活时间（毫秒）
        connectionTestQuery = "SELECT 1" // 对应原validationQuery：连接有效性检测语句
        validationTimeout = 3000 // 对应原validationQueryTimeout：检测超时时间（毫秒）
        testOnBorrow = true
        testWhileIdle = true
        leakDetectionThreshold = 2000 // 可选：开启连接泄漏检测，超过2秒未归还连接将打日志
        defaultTransactionIsolation = java.sql.Connection.TRANSACTION_READ_COMMITTED
    }
}

2. 验证配置是否生效 #

• 开启Hikari调试日志：在logback.groovy或application.yml中添加logging.level.com.zaxxer.hikari=DEBUG，启动应用后查看日志，确认connectionTimeout是否被设置为10000ms。
• 通过JMX查看：利用JConsole或VisualVM连接应用，查看HikariCP的MBean属性，确认参数值是否正确加载。

3. 负载测试额外优化建议 #

• 调整maximumPoolSize：根据JMeter的并发数合理设置，避免连接池过小导致请求排队；同时不要超过MySQL的max_connections参数值（可通过show variables like 'max_connections';查看）。
• 排查连接泄漏：开启leakDetectionThreshold后，若日志中出现连接泄漏提示，检查代码中是否存在未关闭的Connection、Statement或ResultSet。

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