如何将连接归还至oracle.ucp.jdbc.PoolDataSource连接池？

你不需要调用UCP专属的归还API，UCP返回的池化连接是JDBC标准Connection接口的代理实现，直接调用Connection.close()方法即可完成连接归还：该操作不会销毁底层物理连接，只会将连接重置后放回连接池，供后续请求复用。

最佳实践与注意事项 #

• 优先使用Java 7+支持的try-with-resources语法管理连接、Statement、ResultSet资源，无需手动编写finally关闭逻辑，可完全避免因忘记调用close导致的连接泄露问题。
• 禁止将获取到的连接强转为Oracle原生物理连接对象后调用close，该操作会直接销毁底层物理连接，无法归还到连接池，还会导致连接池资源统计异常。
• 若你手动将连接的autoCommit属性设置为false，业务逻辑执行完成后建议主动提交或回滚事务再归还连接。UCP默认会对未提交事务自动回滚，但主动处理可避免不可预期的业务脏数据问题。
• 你可以通过UCP内置的监控方法验证连接归还效果：
  • 调用PoolDataSource.getBorrowedConnectionsCount()可查看当前从池中借出的连接总数
  • 调用PoolDataSource.getAvailableConnectionsCount()可查看当前池内空闲可用的连接数
    调用close后观测两个指标的数值变化，即可确认归还操作是否生效。

代码示例 #

import oracle.ucp.jdbc.PoolDataSource;
import oracle.ucp.jdbc.PoolDataSourceFactory;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.Statement;

public class UcpConnectionReturnDemo {
    public static void main(String[] args) throws Exception {
        // 初始化连接池（仅需全局初始化一次）
        PoolDataSource pds = PoolDataSourceFactory.getPoolDataSource();
        pds.setConnectionFactoryClassName("oracle.jdbc.pool.OracleDataSource");
        pds.setURL("jdbc:oracle:thin:@//<数据库地址>:<端口>/<服务名>");
        pds.setUser("<数据库用户名>");
        pds.setPassword("<数据库密码>");
        pds.setInitialPoolSize(5);
        pds.setMaxPoolSize(20);

        // try-with-resources会在代码块执行结束后自动调用资源的close方法，自动归还连接
        try (Connection conn = pds.getConnection();
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery("SELECT 1 FROM DUAL")) {
            while (rs.next()) {
                System.out.println("查询结果：" + rs.getInt(1));
            }
            // 涉及写操作时主动提交事务
            // conn.commit();
        }
    }
}

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