使用Tomcat时如何在数据库连接关闭时触发Java异常抛出

根因说明 #

你当前配置的Tomcat JDBC连接池removeAbandoned系列参数仅用于回收泄露的空闲连接（即应用拿到连接后长时间未使用、也未主动关闭的场景），不会主动中断正在运行的SQL查询，因此你的20秒延迟测试SQL不会被10秒的连接池超时规则打断，才会出现连接长时间挂起、25分钟后才被回收的问题。

可直接落地的解决方案 #

1. JDBC连接字符串配置全局查询超时

最新版SQL Server驱动原生支持全局查询超时配置，直接在JDBC URL中添加以下参数即可全局生效：

jdbc:sqlserver://[数据库地址]:1433;databaseName=[库名];queryTimeout=10;cancelQueryTimeout=2;[其他原有参数]

• queryTimeout=10：全局默认查询超时时间，单位为秒
• cancelQueryTimeout=2：超时后驱动等待查询取消的最大时间，避免取消逻辑卡住

2. 代码层面指定单SQL超时（更灵活）

如果仅需要针对特定接口的SQL设置超时，不需要全局生效，可在执行SQL前手动设置Statement超时时间：

// 注意USER是SQL Server关键字，需要用方括号包裹避免语法错误
String testSql = "WAITFOR DELAY '00:00:20';SELECT TOP(1) * FROM [USER]";
try (Connection conn = dataSource.getConnection();
     PreparedStatement pstmt = conn.prepareStatement(testSql)) {
    // 单SQL设置10秒超时，优先级高于全局配置
    pstmt.setQueryTimeout(10);
    ResultSet rs = pstmt.executeQuery();
    // 处理查询结果
} catch (SQLTimeoutException timeoutEx) {
    // 直接捕获超时异常，上层POST接口拿到异常后可立即返回响应
    throw new RuntimeException("查询超时，请稍后重试");
}

3. 补充Tomcat连接池配置适配

你之前使用的QueryTimeoutInterceptor未生效是缺少配套配置，在原有Tomcat JDBC参数基础上补充以下两项即可：

# 配置查询超时拦截器，统一对所有查询设置超时
interceptors = QueryTimeoutInterceptor(queryTimeout=10)
# 连接超时回收时强制中止正在运行的查询
abortOnConnectTimeout = true

4. 验证方式

配置完成后运行你现有的测试SQL，10秒左右就会抛出SQLTimeoutException，不会再出现连接挂起25分钟的问题。

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