配置java数据库连接池日志的核心在于区分“连接池内部状态”与“sql执行轨迹”，通常通过调整连接池实现类的特定属性来开启慢查询或借用/归还监控，同时配合logback或log4j2对底层驱动和连接池组件进行分级日志控制。以hikaricp为例，需设置logpoolstatus等参数并配置对应的logger级别为debug或info；对于druid，则需启用proxyfilters中的wallfilter或statfilter。这样做能精准捕获连接泄漏、等待超时及高频sql，便于排查性能瓶颈。
HikariCP如何开启连接池状态监控日志
在HikariCP中，默认情况下不会输出详细的连接借用和归还日志，以避免生产环境日志爆炸。要开启此类监控，主要通过配置com.zaxxer.hikari.HikariConfig中的特定属性，并结合日志框架的级别控制来实现。最常用的是开启logPoolStatus定时打印池状态，或者通过调整org.apache.commons.dbcp2.BasicDataSource（如果是Apache DBCP）或com.zaxxer.hikari包的日志级别来获取更细粒度的信息。对于HikariCP，官方推荐通过isRegisterMbeans结合JMX监控，但若坚持用日志，可借助其内置的LoggingProxy或第三方插件，不过最直接的方式是配置dataSourceProperties中的驱动级日志，并设置HikariCP自身的Logger为DEBUG以捕获异常和警告。
import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
public class HikariLogConfig {
public static void main(String[] args) {
// 1. 创建配置对象
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/testdb");
config.setUsername("root");
config.setPassword("password");
// 2. 关键配置：开启连接池状态日志（每30秒打印一次）
// 注意：HikariCP默认不打印每次borrow/return，此配置仅用于定期健康检查日志
config.addDataSourceProperty("logPoolStatus", "true");
config.setMaximumPoolSize(10);
config.setMinimumIdle(2);
// 3. 创建数据源
try (HikariDataSource ds = new HikariDataSource(config)) {
System.out.println("HikariCP DataSource initialized with logging enabled.");
// 模拟获取连接
try (var conn = ds.getConnection()) {
System.out.println("Connection obtained: " + conn.isValid(1));
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
上述代码中，addDataSourceProperty("logPoolStatus", "true")并非HikariCP的标准直接属性，HikariCP本身并不直接提供logPoolStatus作为DataSourceProperty来控制每次借还。实际上，HikariCP的日志行为主要由SLF4J/Logback控制。若要看到详细的连接活动，通常需要：
1. 将com.zaxxer.hikari的日志级别设为DEBUG，这会记录连接获取失败、超时等异常。
2. 若需类似Druid的SQL监控，HikariCP原生不支持，需结合MyBatis-Plus或PageHelper的拦截器，或使用HikariCP的metricRegistry集成Micrometer。
但为了演示“配置日志”这一动作，我们修正代码为更标准的HikariCP配置，即通过Logback配置来控制，并在代码中展示如何初始化。以下是更准确的Java配置片段，重点在于初始化：
立即学习“Java免费学习笔记（深入）”；
import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
public class HikariConfigExample {
public static void main(String[] args) {
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/mydb");
config.setUsername("user");
config.setPassword("pass");
config.setMaximumPoolSize(5);
// HikariCP 默认使用 SLF4J，无需额外设置 log4j.properties
// 若需调试，确保 logback.xml 中 <logger name="com.zaxxer.hikari" level="DEBUG"/>
HikariDataSource ds = new HikariDataSource(config);
// 使用 ds...
}
}
预期结果：当logback.xml配置了<logger name="com.zaxxer.hikari" level="DEBUG"></logger>时，控制台会输出连接池初始化、连接获取（仅在异常或超时时详细）、以及池状态变更的日志。若无此配置，仅输出ERROR级别信息。
Druid连接池如何配置SQL防火墙与统计日志
Druid连接池提供了强大的内置监控功能，通过配置Filter链可以实现SQL统计、防SQL注入（WallFilter）以及详细的SQL执行日志。核心步骤是在DruidDataSource中注册StatFilter和WallFilter，并通过spring.datasource.filters=stat,wall或在代码中手动添加。StatFilter负责收集SQL执行次数、时间、行数等统计信息，并可配置slowSqlMillis来输出慢SQL日志。WallFilter则用于检测恶意SQL。这些日志默认输出到Druid内置的StatViewServlet或指定的Logger中，具体取决于配置。
import com.alibaba.druid.pool.DruidDataSource;
import com.alibaba.druid.filter.Filter;
import com.alibaba.druid.filter.stat.StatFilter;
import com.alibaba.druid.wall.WallFilter;
import java.sql.SQLException;
import java.util.ArrayList;
import java.util.List;
public class DruidLogConfig {
public static void main(String[] args) throws SQLException {
DruidDataSource dataSource = new DruidDataSource();
dataSource.setUrl("jdbc:mysql://localhost:3306/testdb");
dataSource.setUsername("root");
dataSource.setPassword("password");
// 1. 创建统计过滤器
StatFilter statFilter = new StatFilter();
statFilter.setSlowSqlMillis(100); // 超过100ms视为慢SQL并记录日志
statFilter.setLogSlowSql(true);
// 2. 创建墙过滤器（可选，用于安全）
WallFilter wallFilter = new WallFilter();
// 3. 注册过滤器
List<Filter> filters = new ArrayList<>();
filters.add(statFilter);
filters.add(wallFilter);
dataSource.setProxyFilters(filters);
// 4. 初始化
dataSource.init();
// 测试SQL
try (var conn = dataSource.getConnection();
var stmt = conn.createStatement();
var rs = stmt.executeQuery("SELECT * FROM users WHERE id = 1")) {
while (rs.next()) {
System.out.println(rs.getString("name"));
}
}
dataSource.close();
}
}
预期结果：当执行SQL耗时超过100毫秒时，Druid会在控制台或配置的日志文件中输出类似[WARN] slow sql ...的日志。若SQL被WallFilter判定为非法（如包含DROP TABLE），则会抛出SQLException并记录安全日志。StatFilter还会在应用关闭时打印汇总统计信息。
当连接池日志中出现大量“Connection leak detected”时意味着什么
当连接池日志（特别是HikariCP或Druid）中出现“Connection leak detected”或类似的泄漏警告时，意味着应用程序从连接池获取了连接，但在规定的时间内（由connectionTimeout或自定义的leakDetectionThreshold决定）没有将其归还给池。这通常是由于代码中忘记在finally块或try-with-resources语句中关闭ResultSet、Statement或Connection对象导致的。在HikariCP中，可通过设置leakDetectionThreshold（单位毫秒）来启用泄漏检测，例如设置为30000表示30秒未归还即报警。解决此问题的方法是审查堆栈跟踪中显示的获取连接的代码路径，确保所有数据库资源都被正确关闭，优先使用try-with-resources语法。
