基于JPA与EclipseLink的Java服务如何维持PostgreSQL弹性连接？

我的Java微服务（基于Thornttail）在PostgreSQL数据库重启后会出现连接断开的问题。之前在Keycloak里靠下面这段配置解决过类似问题：

<validation>
    <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker"/>
    <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter"/>
    <stale-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLStaleConnectionChecker"/>
</validation>

现在想在Thornttail应用里实现同样的弹性连接维护功能，考虑修改persistence.xml来实现？当前的persistence.xml内容如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<persistence xmlns="https://jakarta.ee/xml/ns/persistence"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://jakarta.ee/xml/ns/persistence https://jakarta.ee/xml/ns/persistence/persistence_3_0.xsd"
             version="3.0">
    <persistence-unit name="pbm" transaction-type="JTA">
        <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
        <jta-data-source>java:jboss/datasources/***</jta-data-source>

        <properties>
            <property name="eclipselink.jdbc.driver" value="org.postgresql.Driver"/>
            <property name="eclipselink.jdbc.url" value="java:jboss/datasources/greydom"/>
            <property name="eclipselink.target-database"
                      value="org.eclipse.persistence.platform.database.PostgreSQLPlatform"/>
            <property name="eclipselink.connection-pool.max" value="10000"/>
            <property name="eclipselink.connection-pool.wait" value="3000000"/>
            <property name="javax.persistence.jdbc.driver" value="org.postgresql.Driver"/>
            <property name="javax.persistence.jdbc.url" value="java:jboss/datasources/***"/>
        </properties>
    </persistence-unit>
</persistence>

环境信息：

• Java 11
• 用JPA + EclipseLink做持久化
• PostgreSQL数据库

由于你用的是JTA数据源（java:jboss/datasources/***），连接池实际由应用服务器（Thornttail基于WildFly）管控，不是EclipseLink。所以优先配置数据源本身的连接验证规则，再补充EclipseLink的配置，双重保障连接稳定性。

1. 配置Thornttail数据源（推荐） #

Thornttail可以通过project-defaults.yml或者standalone.xml配置数据源的连接验证，直接复用你在Keycloak里用的那三个类：

方式一：用project-defaults.yml配置 #

在项目的src/main/resources/project-defaults.yml里添加以下配置：

thornttail:
  datasources:
    data-sources:
      YourDataSourceName: # 替换成你实际的数据源名称，对应JNDI里的***部分
        driver-name: postgresql
        connection-url: jdbc:postgresql://你的数据库地址:5432/数据库名 # 换成实际地址
        user-name: 数据库用户名
        password: 数据库密码
        validation:
          valid-connection-checker-class-name: org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker
          exception-sorter-class-name: org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter
          stale-connection-checker-class-name: org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLStaleConnectionChecker
          validate-on-match: true # 获取连接时立即验证
          background-validation: true # 后台定期验证
          background-validation-millis: 60000 # 每分钟验证一次

方式二：用standalone.xml配置 #

如果用传统WildFly配置文件，找到<datasources>下的对应数据源，添加<validation>节点：

<datasource jndi-name="java:jboss/datasources/YourDataSourceName" pool-name="YourDataSourceName" enabled="true" use-java-context="true">
    <!-- 保留原有driver、url、user、password等配置 -->
    <validation>
        <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker"/>
        <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter"/>
        <stale-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLStaleConnectionChecker"/>
        <validate-on-match>true</validate-on-match>
        <background-validation>true</background-validation>
        <background-validation-millis>60000</background-validation-millis>
    </validation>
</datasource>

2. 补充EclipseLink连接池配置（可选但建议） #

在persistence.xml的<properties>里添加以下EclipseLink专属配置，强化连接池弹性：

<properties>
    <!-- 保留你原有的配置 -->
    <property name="eclipselink.jdbc.driver" value="org.postgresql.Driver"/>
    <property name="eclipselink.jdbc.url" value="java:jboss/datasources/greydom"/>
    <property name="eclipselink.target-database"
              value="org.eclipse.persistence.platform.database.PostgreSQLPlatform"/>
    <property name="eclipselink.connection-pool.max" value="10000"/>
    <property name="eclipselink.connection-pool.wait" value="3000000"/>
    <property name="javax.persistence.jdbc.driver" value="org.postgresql.Driver"/>
    <property name="javax.persistence.jdbc.url" value="java:jboss/datasources/***"/>

    <!-- 新增连接验证配置 -->
    <property name="eclipselink.connection-pool.validate-on-acquire" value="true"/>
    <property name="eclipselink.connection-pool.validate-on-release" value="false"/>
    <!-- PostgreSQL连接验证SQL，也可以用EclipseLink内置验证器 -->
    <property name="eclipselink.jdbc.validation-query" value="SELECT 1"/>
    <!-- 设置连接闲置超时，避免池里的连接长期失效 -->
    <property name="eclipselink.connection-pool.max-idle-time" value="300000"/> <!-- 5分钟 -->
</properties>

注意事项 #

• 你原有的persistence.xml里同时配置了eclipselink.jdbc.url和javax.persistence.jdbc.url为JNDI地址，没问题，但建议保持一致，避免混淆。
• 连接池最大连接数设为10000太大了，建议根据实际业务调整（比如100-200），别给数据库加太大负载。
• 要确保项目里有jboss-jdbc-adapters相关依赖，不然PostgreSQL的连接验证类会找不到。用Maven的话可以加：

<dependency>
    <groupId>org.jboss.ironjacamar</groupId>
    <artifactId>ironjacamar-jdbc</artifactId>
    <version>1.4.32.Final</version> <!-- 根据Thornttail版本选合适的版本 -->
</dependency>

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