调用java.sql.SQLXML.free()引发数据库连接泄漏的问题排查与解决

哈哈，这个问题我之前踩过坑！核心问题其实很直白——你只释放了SQLXML对象，却完全忘了把从数据源拿到的Connection归还到连接池里！

SQLXML是绑定在Connection上的资源，调用sqlXML.free()只会释放SQLXML自身的内存和相关资源，但底层的Connection如果不关闭（或者说归还到连接池），连接池里的可用连接会被持续占用，越积越多最终就导致了连接泄漏。

这里有两种靠谱的解决方式，按推荐优先级排序：

1. 交给JdbcTemplate管理连接（最符合Spring最佳实践） #

既然已经在用JdbcTemplate，不如直接利用它的回调方法帮你处理连接的获取和归还，完全不用手动操作Connection：

jdbcTemplate.execute((ConnectionCallback<Void>) conn -> {
    // 用try-with-resources自动释放SQLXML
    try (SQLXML sqlXML = conn.createSQLXML()) {
        // 这里执行你的SQLXML相关业务操作
        return null;
    } catch (SQLException e) {
        // 处理异常或向上抛出
        throw new RuntimeException("操作SQLXML资源失败", e);
    }
});

JdbcTemplate会自动帮你从连接池拿连接，执行完回调后自动把连接归还回去，从根源上避免了泄漏风险。

2. 手动用try-with-resources管理Connection #

如果一定要手动获取Connection，务必用try-with-resources语法（因为Connection是AutoCloseable接口的实现类），确保连接会被自动关闭：

// 用try-with-resources包裹Connection，自动归还到连接池
try (Connection conn = jdbcTemplate.getDataSource().getConnection()) {
    SQLXML sqlXML = conn.createSQLXML();
    try {
        // 执行你的SQLXML操作
    } finally {
        if (sqlXML != null) {
            try {
                sqlXML.free();
            } catch (SQLException e) {
                // 记录错误日志
                log.error("释放SQLXML资源失败", e);
            }
        }
    }
} catch (SQLException e) {
    // 处理连接获取或SQL操作异常
    log.error("数据库操作失败", e);
}

甚至可以把SQLXML也放进try-with-resources里，进一步简化代码：

try (Connection conn = jdbcTemplate.getDataSource().getConnection();
     SQLXML sqlXML = conn.createSQLXML()) {
    // 执行你的SQLXML操作
} catch (SQLException e) {
    // 处理异常
    log.error("数据库操作失败", e);
}

这样Connection和SQLXML都会被自动释放，不用手动写finally块，代码更简洁安全。

记住一个核心原则：谁获取的资源谁负责释放，你从数据源拿了Connection，就必须确保它被归还。而用JdbcTemplate的回调方法是最省心的方式，Spring已经帮你封装了连接管理的逻辑，不用自己操心泄漏问题。

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