JdbcTemplate执行/更新挂起，但Connection.createStatement().execute正常问题排查

问题描述 #

我有一个基于Spring的Kotlin应用，使用JdbcTemplate与PostgreSQL交互。连续执行多条SQL语句时，部分语句会随机导致JdbcTemplate方法挂起约30分钟（该SQL在DBeaver中仅需1秒，返回约90行数据）。为何会出现这种情况？为何Connection方式可正常执行，JdbcTemplate却不行？

原JdbcTemplate实现代码 #

transactionTemplate.executeWithoutResult {
    try {
        jdbcTemplate.execute(sql)
    } catch (ex: Exception) {
        log.error("...")
    }
}

替换为直接使用Connection的正常代码 #

val cur = DriverManager.getConnection(...).createStatement()

transactionTemplate.executeWithoutResult {
    try {
        cur.execute(sql)
    } catch (ex: Exception) {
        log.error("...")
    }
}

SQL语句类似 INSERT INTO table SELECT * FROM (select ...) t

原因分析与排查建议 #

1. 事务上下文与连接池的绑定冲突 #

你用transactionTemplate管理事务时，JdbcTemplate会自动绑定当前事务上下文的连接，而直接通过DriverManager.getConnection()获取的连接脱离了Spring事务和连接池的管理：

• 连续执行SQL时，若事务未正确释放连接，或连接池的maxPoolSize过小，会导致JdbcTemplate等待空闲连接，你看到的30分钟大概率是连接池的connectionTimeout配置值。
• 直接创建的连接不受连接池限制，也不参与Spring事务的连接复用逻辑，因此不会出现等待阻塞。

2. JdbcTemplate的事务适配逻辑影响 #

JdbcTemplate的execute方法会做额外的事务适配：

• 在事务上下文内，它会将连接的autoCommit设为false，而直接使用Statement时默认沿用连接的初始autoCommit配置（通常为true）。这种差异可能导致PostgreSQL在处理批量写入（比如INSERT ... SELECT）时出现锁等待或事务阻塞。
• JdbcTemplate还会触发元数据校验、参数预处理等额外操作，若驱动对这些操作的处理存在兼容性问题，也可能引发挂起。

3. 连接池配置不合理 #

如果使用HikariCP等连接池，以下配置可能是诱因：

• connectionTimeout设置过大：当连接池无可用连接时，JdbcTemplate会一直等待，直到超时。
• idleTimeout或maxLifetime配置不当：导致连接池内的连接被频繁回收或创建，引发连接争抢。

排查方向 #

• 查看连接池日志，确认是否存在Timeout waiting for connection from pool这类报错，验证是否为连接等待导致的挂起。
• 移除transactionTemplate（若业务不需要事务），直接用JdbcTemplate执行SQL，观察是否还会出现挂起。
• 对比两种方式的JDBC连接属性：比如autoCommit状态、事务隔离级别，看差异是否导致数据库端阻塞。
• 开启PostgreSQL的慢查询日志，检查挂起时数据库端的SQL执行状态，确认是应用端等待还是数据库锁冲突。

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