为何WildFly 12中Hibernate未将连接归还至连接池？

看起来你在从WebLogic迁移到WildFly时碰到了典型的连接泄漏问题——明明配置了连接释放相关参数，但池里的连接还是很快被耗尽。结合你的场景，我从几个核心方向给你排查建议：

1. 确认Hibernate连接释放模式与WildFly JTA环境的适配 #

你提到已经设置了connection.release_mode，但在WildFly的JTA容器环境下，这个参数的最优设置和WebLogic存在差异：

• 如果你用的是容器管理的数据源（推荐方式，而非Hibernate自带连接池），请确保hibernate.connection.release_mode设置为after_transaction（这是JTA环境下的默认值，但旧配置可能会覆盖它）。
• 避免使用on_close模式，这种模式依赖手动关闭Session才能释放连接，在容器托管事务下极易引发泄漏。
• 核对你提到的两个参数：transaction.flush_before_completion和transaction.auto_close_session在JTA环境下应设为true，但要注意它们和容器事务的联动——如果WildFly事务管理器已接管事务，这两个参数需要和Hibernate的JTA配置协同生效。

2. 检查WildFly数据源的配置（重中之重） #

WildFly的数据源管理逻辑和WebLogic差异很大，很多连接泄漏其实是数据源配置不当导致的：

• 首先确认你在persistence.xml或hibernate.cfg.xml中引用的是WildFly容器提供的DataSource（比如java:jboss/datasources/YourDS这类JNDI名称），而非让Hibernate自行创建连接池。
• 登录WildFly控制台查看数据源配置：
  • 开启连接有效性检查：设置check-valid-connection-sql（比如SELECT 1）、validate-on-match或background-validation，确保连接池能回收失效连接。
  • 配置连接超时与回收：设置idle-timeout-minutes（比如15分钟）、合理的max-pool-size，以及leak-detection-interval（比如30秒）——开启泄漏检测后，WildFly会日志记录长时间未归还的连接，帮你定位问题点。
• 如果你用的是WildFly默认的HikariCP连接池，检查hikari相关参数，比如connectionTimeout、leakDetectionThreshold（设为30000毫秒，超过这个时长未归还的连接会被标记为泄漏）。

3. 验证Hibernate与WildFly JTA事务的整合配置 #

在WildFly中，Hibernate必须正确适配容器的JTA事务管理器，否则连接释放会出现异常：

• 确保hibernate.transaction.jta.platform设置为org.hibernate.service.jta.platform.internal.JBossAppServerJtaPlatform（这是WildFly专属的JTA平台实现）。
• 检查persistence.xml中的事务类型：如果是容器管理事务，设置<transaction-type>JTA</transaction-type>；如果是应用管理事务，确保代码中正确手动提交/回滚事务并关闭Session。

4. 代码层面排查连接泄漏 #

有时候配置没问题，但代码里的Session/Connection管理存在疏漏：

• 检查所有获取Session的地方，优先使用try-with-resources语法自动关闭Session：

  try (Session session = sessionFactory.getCurrentSession()) {
      // 业务逻辑代码
  }
  

  若用传统写法，务必在finally块中执行session.close()（注意：容器托管的Session无需手动关闭，Hibernate会在事务结束后自动处理）。
• 排查是否存在长时间持有Session的情况，比如在事务外打开Session、或在循环中重复获取Session但未释放。

5. 开启日志定位泄漏点 #

最有效的排查方式是通过日志追踪连接的生命周期：

• 开启Hibernate的JDBC资源日志，在standalone.xml中添加配置：

  <logger category="org.hibernate.resource.jdbc">
      <level name="DEBUG"/>
  </logger>
  

  这样可以看到每个连接的获取、使用、释放日志，快速定位未释放连接的操作。
• 开启WildFly数据源日志：

  <logger category="com.zaxxer.hikari">
      <level name="DEBUG"/>
  </logger>
  

  若是HikariCP，它会记录连接泄漏的具体堆栈信息，直接帮你定位到泄漏代码的位置。

6. 版本兼容性检查 #

WildFly 12自带的Hibernate版本是5.1.x，如果你原来在WebLogic上用的是Hibernate 4.x，可能存在兼容性冲突：

• 检查项目依赖，是否排除了WildFly自带的Hibernate、强行使用旧版本？这种情况极易引发连接管理逻辑的冲突。
• 尽量使用WildFly自带的Hibernate版本，或确保你的Hibernate版本（比如5.1.x或兼容的5.2.x）和WildFly的JTA、数据源实现兼容。

建议你先开启泄漏检测和日志，定位到具体是哪段代码或哪个配置导致的连接未释放，再针对性修复。

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