Spring Boot容器无法连通Docker同网络下MySQL容器的配置问题咨询

核心错误原因梳理 #

你出现的两个问题都是典型的Docker容器网络+Spring配置误解：

• 容器内访问localhost指向的是当前Spring容器本身，不是宿主机，所以无法通过宿主机映射的3309端口访问MySQL容器
• 自定义bridge网络的作用是让同网络下的容器可以通过容器名/服务名互相解析，你直接把网络名lms-network当做数据库域名填写是错误的

操作步骤 #

1. 前置网络校验 #

首先确认两个容器已经加入同一个自定义桥接网络：

• 执行docker network inspect lms-network，查看返回结果的Containers字段，确认同时包含MySQL和Spring容器的ID
• 如果容器不在网络内，执行以下命令添加：

  docker network connect lms-network <你的MySQL容器名>
  docker network connect lms-network <你的Spring容器名>
  

• 记住你的MySQL容器启动时设置的--name参数值，后续会作为数据源的主机地址。

2. 修正数据源配置 #

容器间通信不需要走宿主机映射端口，直接用MySQL容器的内部默认端口3306，正确的JDBC URL格式为：

spring.datasource.url=jdbc:mysql://<你的MySQL容器名>:3306/library?useSSL=false&allowPublicKeyRetrieval=true

比如你MySQL容器命名为mysql-lms，配置就为：
spring.datasource.url=jdbc:mysql://mysql-lms:3306/library

3. 解决Jar包构建失败问题 #

你改配置后打包失败，是因为本地构建时mysql-lms这类容器名只能在Docker网络内解析，本地环境无法识别，触发Spring Boot的数据库连接校验导致构建终止，可任选以下方案解决：

• 方案一：打包时跳过校验，执行打包命令时添加跳过参数：

  mvn clean package -DskipTests -Dspring.datasource.continue-on-error=true
  

• 方案二（更推荐）：不写死配置，启动Spring容器时通过环境变量动态注入数据源配置，本地打包保留原来的localhost:3309配置不影响构建：

  docker run -d \
  --name spring-lms \
  --network lms-network \
  -e SPRING_DATASOURCE_URL="jdbc:mysql://mysql-lms:3306/library" \
  -e SPRING_DATASOURCE_USERNAME=<你的数据库账号> \
  -e SPRING_DATASOURCE_PASSWORD=<你的数据库密码> \
  joshuad23/spring-docker
  

  Spring Boot会自动识别SPRING_开头的环境变量，覆盖配置文件中的对应项。

4. 连通性验证 #

如果修改后仍然无法连接，可以进入Spring容器内部验证网络连通性：

docker exec -it <你的Spring容器名> ping <你的MySQL容器名>

• 如果ping不通：重新检查两个容器的网络归属配置
• 如果ping得通：检查MySQL账号是否开启了远程访问权限，以及账号密码是否匹配。

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