Docker内Spring Boot应用JDBC无法连接宿主机MySQL问题排查

• 首先补充完整JDBC连接必填参数
  MySQL 5.7高版本及对应JDBC驱动要求必须显式配置SSL、时区、公钥获取相关参数，否则会出现无明确报错的连接失败，可先替换为如下连接串测试：

this.conn = DriverManager.getConnection("jdbc:mysql://172.24.0.1:3306/myDB?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai&user=xxxx&password=xxxx");

注意：时区参数可根据宿主机实际时区调整为GMT+8等其他有效值

• 核对MySQL账号权限匹配规则
  MySQL账号采用用户名@来源主机的匹配逻辑，命令行登录成功不代表JDBC连接时权限合法，可在宿主机登录MySQL执行以下命令查看账号权限：

SELECT user,host FROM mysql.user WHERE user='xxxx';

如果返回的host字段不是%或未包含容器网段172.24.0.0/16，执行以下命令开放权限：

GRANT ALL PRIVILEGES ON myDB.* TO 'xxxx'@'172.24.%' IDENTIFIED BY '你的实际密码';
FLUSH PRIVILEGES;

• 校验JDBC驱动版本兼容性
  你使用的MySQL版本为5.7.35，需注意驱动版本和配置的对应关系：
  1. 若使用mysql-connector-java 5.x版本驱动，驱动类为com.mysql.jdbc.Driver，无需强制配置时区参数
  2. 若使用mysql-connector-java 8.x版本驱动，驱动类为com.mysql.cj.jdbc.Driver，必须显式配置serverTimezone参数
     可检查pom.xml中的依赖配置，推荐使用匹配5.7版本的驱动：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.49</version>
</dependency>

• 打印完整异常堆栈定位问题
  在JDBC连接逻辑处增加异常捕获逻辑，根据错误码快速定位根因：

try {
    this.conn = DriverManager.getConnection("修改后的完整连接串");
} catch (SQLException e) {
    e.printStackTrace();
    System.out.println("错误码：" + e.getErrorCode());
    System.out.println("SQL状态：" + e.getSQLState());
}

常见错误码对应问题：1045为权限配置错误、1049为数据库名拼写错误、08S01为驱动/网络参数配置错误。

• 排查Java网络配置限制
  部分容器镜像默认优先使用IPv6导致JDBC连接IPv4地址失败，可在启动Spring Boot时增加JVM参数强制使用IPv4：

java -Djava.net.preferIPv4Stack=true -jar 你的应用包名.jar

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