连接池初始化失败通常发生在应用启动阶段，表现为日志中出现Error creating DataSource、Failed to validate connection或SQLException/ClassNotFoundException；需按配置、依赖、网络、数据库四类根因顺序排查：先核对URL参数（如useSSL=false）、用户名密码转义、驱动类名匹配；再确认连接池与JDBC驱动依赖无冲突且版本兼容；接着telnet直连验证网络可达性及防火墙策略；最后开启DEBUG日志定位Caused by底层异常。
连接池初始化失败通常发生在应用启动阶段，表现为日志中出现 Error creating DataSource、Failed to validate connection 或直接抛出 SQLException / ClassNotFoundException。排查需聚焦配置、依赖、网络和数据库四类根因，按顺序验证更高效。
检查基础配置是否合法且完整
配置错误是最常见原因，必须逐项核对：
-
URL 格式与参数：MySQL 连接串必须包含
useSSL=false（若服务端未启用 SSL）或allowPublicKeyRetrieval=true（MySQL 8.0+），否则握手失败；端口、数据库名、IP 地址拼写不能有空格或编码问题 -
用户名密码：确认无特殊字符未转义（如
@、/需 URL 编码）；密码在 YAML/properties 中若含$或{}可能被 Spring 占位符解析器误处理 -
驱动类名：MySQL 5.x 用
com.mysql.jdbc.Driver，8.x 必须用com.mysql.cj.jdbc.Driver；PostgreSQL 对应org.postgresql.Driver；类名大小写、包路径一个字母都不能错
确认依赖是否正确引入且无冲突
类找不到或初始化卡死，大概率是依赖问题：
-
非 Spring 项目：必须显式添加
com.alibaba:druid（Druid）、com.zaxxer:HikariCP（Hikari）等核心 jar；仅加druid-spring-boot-starter而手动 new DataSource 会报NoClassDefFoundError -
Spring Boot 项目：检查是否意外引入了多个连接池（如同时有 Hikari 和 Druid），导致自动配置冲突；执行
mvn dependency:tree | grep -i "hikari\|druid"查看实际加载的版本 -
版本兼容性：Druid ≥1.2.20 支持 JDK 17+；MySQL 驱动 8.0.x 需匹配 MySQL 5.7+ 服务端；低版本驱动连高版本 DB 易触发
Communications link failure
验证网络与数据库服务可达性
配置和依赖都对，但连不上，问题往往出在通路：
立即学习“Java免费学习笔记（深入）”；
-
直连测试：在应用服务器上运行
telnet db-host 3306或nc -zv db-host 3306，确认端口可通；不通则查防火墙、安全组、NAT 网关策略 -
防火墙静默断连：若连接池启动成功但运行中突然失效（报
Connection reset、Socket closed），抓包看是否有长时间空闲后突现 RST；确认防火墙 TCP 空闲超时（如 AWS NAT 网关默认 300 秒），并确保连接池idle-timeout小于该值至少 30 秒 -
数据库状态：登录 DB 执行
show status like 'Threads_connected';，确认未达最大连接数；检查wait_timeout（MySQL 默认 8 小时）是否远大于防火墙超时，否则连接池复用失效连接
开启详细日志定位具体失败点
日志是唯一可信线索，务必打开 DEBUG 级别：
-
HikariCP：设
logging.level.com.zaxxer.hikari=DEBUG，关注Cannot obtain owner（连接获取超时）、Failed to validate connection（校验 SQL 执行失败）等关键行 -
Druid：启用
druid.stat.mergeSql=true和druid.logSlowSql=true，配合logging.level.com.alibaba.druid=DEBUG查看初始化时的 validationQuery 执行结果 -
通用技巧：异常堆栈最底部的
Caused by:行才是真因——比如java.net.UnknownHostException是 DNS 解析失败，javax.net.ssl.SSLException: protocol_version是 TLS 版本不匹配，Access denied for user是权限问题
