Hibernate无法识别persistence.xml中DBCP2连接池配置问题

你遇到的问题核心是Hibernate没正确识别你配置的DBCP2连接池参数，自动回退到了内置的连接池。这主要是因为你用了旧版DBCP1的配置前缀，而非DBCP2对应的属性，或者没明确指定连接池提供者。下面是两种可行的解决方案：

方案一：替换为DBCP2专属配置前缀 #

Hibernate对DBCP2的配置属性前缀是hibernate.dbcp2.*，而你当前用的hibernate.dbcp.*是给旧版DBCP1用的。修改persistence.xml中的连接池属性即可：

<properties>
    <!-- 保留原有数据库驱动、URL、方言等属性 -->
    <property name="hibernate.dbcp2.initialSize" value="5"/>
    <property name="hibernate.dbcp2.maxTotal" value="20"/>
    <property name="hibernate.dbcp2.maxIdle" value="10"/>
    <property name="hibernate.dbcp2.minIdle" value="5"/>
    <property name="hibernate.dbcp2.maxWaitMillis" value="-1"/>
</properties>

方案二：明确指定DBCP2连接池提供者 #

更稳妥的方式是直接告诉Hibernate使用DBCP2的连接池实现类，在persistence.xml的properties节点中添加以下属性：

<property name="hibernate.connection.provider_class" value="org.hibernate.connection.DBCP2ConnectionProvider"/>

添加这个属性后，Hibernate会直接加载DBCP2连接池，即使你没修改前缀也能生效（不过还是建议改成dbcp2前缀保持配置一致性）。

额外检查项 #

• 确认build.gradle的依赖引入正确：

  compile group: 'org.apache.commons', name: 'commons-dbcp2', version: '2.2.0'
  

  这个依赖会自动引入commons-pool2（DBCP2依赖的池实现），无需额外添加。
• 如果你使用Hibernate 5.3及以上版本，DBCP2ConnectionProvider的路径已变更为org.hibernate.engine.jdbc.connections.internal.DBCP2ConnectionProvider，如果遇到类找不到的错误，替换成这个路径即可。

修改完成后重启应用，Hibernate就会正常使用DBCP2连接池，那个内置连接池的警告也会消失。

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