无法在JDBC/Hikari连接池中设置超时变量的问题求助

问题根源 #

你在JDBC URL里直接写wait_timeout=77&interactive_timeout=78是错误的——这俩是MySQL的系统变量，并非JDBC连接属性，这么写根本不会修改MySQL的会话/全局变量。另外要分清Hikari配置的两个超时参数的作用：

• connectionTimeout：从连接池获取连接的最长等待时间，和MySQL端的超时规则无关
• idleTimeout：连接在池内闲置多久后被回收，同样不影响MySQL的wait_timeout/interactive_timeout参数

正确的设置方式 #

方式1：连接建立后手动执行SET语句（会话级生效） #

每次获取连接后，执行SET语句设置当前会话的超时变量，仅对当前连接有效：

HikariConfig hikariConfig = new HikariConfig();
hikariConfig.setJdbcUrl("jdbc:mysql://*/*");
hikariConfig.setUsername("*");
hikariConfig.setPassword("*");
hikariConfig.setConnectionTimeout(65 * 1000);
hikariConfig.setIdleTimeout(66 * 1000);

HikariDataSource hikariDataSource = new HikariDataSource(hikariConfig);
try (Connection connection = hikariDataSource.getConnection();
     Statement statement = connection.createStatement()) {
    // 设置当前会话的超时变量
    statement.execute("SET wait_timeout=77");
    statement.execute("SET interactive_timeout=78");
    
    // 验证设置结果
    ResultSet resultSet = statement.executeQuery("show variables like '%timeout%'");
    while (resultSet.next()) {
        System.out.println(resultSet.getString(1) + " " + resultSet.getString(2));
    }
} catch (SQLException e) {
    e.printStackTrace();
}

方式2：用MySQL JDBC驱动的sessionVariables参数（URL配置） #

MySQL JDBC驱动支持通过sessionVariables参数在URL中一次性设置多个会话变量，更简便：

HikariConfig hikariConfig = new HikariConfig();
// 格式：sessionVariables=变量1=值1,变量2=值2
hikariConfig.setJdbcUrl("jdbc:mysql://*/*?sessionVariables=wait_timeout=77,interactive_timeout=78");
hikariConfig.setUsername("*");
hikariConfig.setPassword("*");
hikariConfig.setConnectionTimeout(65 * 1000);
hikariConfig.setIdleTimeout(66 * 1000);

HikariDataSource hikariDataSource = new HikariDataSource(hikariConfig);
try (Connection connection = hikariDataSource.getConnection();
     Statement statement = connection.createStatement()) {
    ResultSet resultSet = statement.executeQuery("show variables like '%timeout%'");
    while (resultSet.next()) {
        System.out.println(resultSet.getString(1) + " " + resultSet.getString(2));
    }
} catch (SQLException e) {
    e.printStackTrace();
}

方式3：修改MySQL全局配置（所有连接生效） #

如果要让所有连接都应用该超时规则，可修改MySQL的配置文件（my.cnf或my.ini），添加或修改：

wait_timeout=77
interactive_timeout=78

修改后重启MySQL服务即可，此方式全局生效，无需在代码中额外设置。

额外提示 #

• 若希望池内所有连接都自动带上超时设置，可配置Hikari的connectionInitSql，每次从池内取出连接时都会执行初始化SQL：

hikariConfig.setConnectionInitSql("SET wait_timeout=77; SET interactive_timeout=78;");

• MySQL的wait_timeout针对非交互式连接（JDBC连接默认属于此类），interactive_timeout针对交互式连接（如MySQL客户端），按需设置即可。

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