1. 问题现象与背景解析上周排查一个线上问题时遇到了典型的数据库连接池报错java.sql.SQLNonTransientConnectionException: No operations allowed after connection closed。这个异常通常发生在使用MyBatis配合连接池如Druid、HikariCP的场景中表面看是连接已关闭却仍被使用但背后往往隐藏着更复杂的根源。今天我们就来彻底拆解这个连接已关闭异常的各种成因和解决方案。这个错误的核心在于连接的生命周期管理。当应用尝试使用一个已经被归还给连接池的数据库连接时连接池会抛出此异常。值得注意的是该异常属于NonTransient非瞬时类型意味着如果不修复根本原因单纯重试操作也会失败。2. 连接池工作原理与异常触发机制2.1 连接池的核心工作流程现代连接池如Druid/HikariCP的工作流程通常包含初始化时创建若干连接放入池中应用请求连接时从池中取出可用连接使用完毕后应用将连接归还给连接池连接池对归还的连接进行健康检查validation关键点在于连接池会通过代理模式包装物理连接。当应用调用connection.close()时实际是将连接标记为可复用状态返回池中而非真正关闭物理连接。2.2 异常触发的主要场景通过分析堆栈信息我们发现该异常通常出现在以下几种情况场景类型典型表现根本原因连接泄漏长时间运行后突然爆发未正确关闭连接忘记try-with-resources事务超时伴随事务超时日志事务未在超时时间内完成连接验证失败连接取出时立即报错连接池的testOnBorrow检测失败多线程竞争随机出现且难以复现多线程共享同一个连接对象3. 完整诊断流程与解决方案3.1 连接泄漏排查方案这是最常见的原因可通过以下步骤确认启用Druid的监控统计spring.datasource.druid.filter.stat.enabledtrue检查活跃连接数是否持续增长// 获取DruidDataSource监控数据 DruidDataSource dataSource (DruidDataSource)applicationContext.getBean(dataSource); log.info(活跃连接数: {}, dataSource.getActiveCount());添加连接打开位置的追踪Druid配置spring.datasource.druid.filtersstat,wall,log4j spring.datasource.druid.connection-propertiesdruid.log.stmt.executableSqltrue重要提示务必使用try-with-resources语法确保连接关闭try (SqlSession session sqlSessionFactory.openSession()) { UserMapper mapper session.getMapper(UserMapper.class); // 业务操作... } // 自动关闭session和connection3.2 事务超时问题处理当使用Transactional时需特别注意检查事务超时设置是否合理Transactional(timeout 30) // 单位秒 public void batchProcess() { // 长时间操作... }对于批量操作建议拆分事务// 每100条提交一次 for (int i 0; i total; i 100) { transactionTemplate.execute(status - { processBatch(items.subList(i, Math.min(i 100, total))); return null; }); }3.3 连接验证配置优化建议采用以下最佳实践配置spring: datasource: druid: # 连接检测配置 test-while-idle: true test-on-borrow: false # 生产环境建议关闭影响性能 test-on-return: false validation-query: SELECT 1 FROM DUAL validation-query-timeout: 1 time-between-eviction-runs-millis: 60000 # 60秒检测一次 min-evictable-idle-time-millis: 300000 # 5分钟4. 高级场景与疑难问题4.1 MyBatis一级缓存导致的连接持有当启用一级缓存时默认开启同一个SqlSession会重复使用同一个连接。解决方案对于查询密集型操作可主动清空缓存sqlSession.clearCache();或使用STATEMENT级别缓存settings setting namelocalCacheScope valueSTATEMENT/ /settings4.2 连接池参数计算公式合理的连接池大小应遵循连接数 ((核心数 * 2) 有效磁盘数)例如4核CPU1块SSD的服务器// 理想连接池大小 int poolSize (4 * 2) 1 94.3 分布式事务的特殊处理在使用Seata等分布式事务框架时需要额外配置# Seata与Druid集成配置 spring.datasource.druid.filtersstat,config spring.datasource.druid.filter.config.enabledtrue5. 生产环境监控方案建议部署以下监控指标Prometheus监控配置示例- pattern: druid.stat.name name: druid_$1 labels: application: ${spring.application.name}关键报警阈值设置活跃连接数 最大连接数的80%等待线程数 5获取连接平均耗时 200ms6. 典型错误案例实录案例一分页查询导致连接泄漏// 错误写法未关闭ResultSet ResultSet rs statement.executeQuery(SELECT * FROM large_table); while (rs.next()) { // 处理数据... } // 忘记rs.close()正确写法应使用MyBatis的分页插件dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper-spring-boot-starter/artifactId /dependency案例二异步回调中误用连接Async public void asyncProcess() { // 异步方法中使用独立事务 transactionTemplate.execute(status - { // 业务操作... return null; }); }通过以上分析和解决方案我们基本可以覆盖90%以上的连接已关闭异常场景。在实际项目中建议结合APM工具如SkyWalking进行连接生命周期追踪可以更直观地定位问题根源。