必须显式设置poolName，因默认生成的匿名名（如HikariPool-1）在多数据源、重启或扩容时易混淆，导致监控和日志无法稳定关联业务；HikariCP需用spring.datasource.hikari.pool-name（带连字符）配置，Druid则用name属性，推荐格式ds-{业务域}-{读写类型}。
在 Java 应用中为连接池配置 poolName 是线上问题排查的关键一步——它能让日志、监控、JMX 或 APM 工具（如 SkyWalking、Arthas、Prometheus）快速定位是哪个数据源的连接出现了慢 SQL、连接泄漏或超时问题。
为什么 poolName 必须显式设置？
多数主流连接池（HikariCP、Druid、Tomcat JDBC）默认会生成匿名或自增名称（如 HikariPool-1、DruidDataSource-1），多个数据源共存时极易混淆。一旦服务重启或集群扩容，序号可能变化，导致日志中无法稳定关联业务模块。
HikariCP 中正确配置 poolName
以 Spring Boot + HikariCP 为例，在 application.yml 中明确指定：
注意：必须使用 pool-name（带连字符），不是 poolName（驼峰）——YAML 配置项名与 Java Bean 属性名不一致
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
-
spring.datasource.hikari.pool-name: ds-order-write（订单写库） -
spring.datasource.hikari.pool-name: ds-user-read（用户读库） - 推荐格式：
ds-{业务域}-{读写类型}，避免空格和特殊字符
Druid 连接池设置方式
Druid 使用 name 属性，且对大小写和格式更敏感，建议统一小写+短横线：
spring.datasource.druid.name=ds-payment-main- 若使用
DruidDataSource手动配置，调用setName("ds-inventory") - 该 name 会出现在 Druid 内置监控页（
/druid/index.html）和日志中
配合日志输出增强可追溯性
仅设 poolName 不够，还需让数据库操作日志带上池标识：
- HikariCP 日志默认含 poolName（如
[HikariPool-2 housekeeper]），开启DEBUG级别可见 - MyBatis/MyBatis-Plus 可通过自定义
Interceptor在 SQL 日志前缀注入当前数据源名（需结合RoutingDataSource或@DS注解） - Logback 中可通过
%X{dsName}MDC 字段透传，需在获取连接时写入（适合多租户或动态数据源场景）
