Docker容器通信异常：Java后端无法连接MySQL数据库

针对你遇到的本地能连MySQL但容器间用服务名database无法连接的问题，以下是具体排查点和解决方案：

1. 解决depends_on的启动时序问题 #

depends_on仅保证数据库容器先启动，但不保证MySQL服务完全就绪（比如初始化、权限配置还没完成）。后端启动时数据库可能还没准备好，导致连接超时。

修复方案： #

在docker-compose.yml的database服务中添加健康检查，让后端等待数据库真正就绪后再启动：

services:
  database:
    # 原有配置...
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "db_user", "-ppassword"]
      interval: 5s
      timeout: 5s
      retries: 5
  backend:
    # 原有配置...
    depends_on:
      database:
        condition: service_healthy  # 等待数据库健康检查通过

2. 检查数据库用户的访问权限 #

本地连接用127.0.0.1能成功，但容器内后端的请求来自Docker网段（比如172.x.x.x），如果db_user仅被授权本地访问（localhost或127.0.0.1），就会被拒绝。

修复方案： #

进入MySQL容器执行授权命令：

docker exec -it database mysql -u root -ppassword
# 执行授权语句
GRANT ALL PRIVILEGES ON databasename.* TO 'db_user'@'%' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

%表示允许从任意IP访问，也可以指定Docker网段（比如172.17.0.0/16）提升安全性。

3. 修正JDBC URL配置 #

问题点： #

• 你的环境变量DB_URL是mysql://database/databasename，但JDBC URL需要完整前缀jdbc:mysql://
• 缺少必要的连接参数（比如关闭SSL、允许公钥检索、设置时区），这些参数在容器环境中常导致连接失败

修复方案： #

更新docker-compose.yml中的环境变量为完整JDBC格式：

services:
  backend:
    environment:
      DB_URL: jdbc:mysql://database:3306/databasename?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC

同时确认后端代码正确读取环境变量DB_URL，没有硬编码的JDBC URL覆盖配置。

4. 验证容器网络连通性 #

如果以上都没问题，检查两个容器是否在同一Docker网络：

# 查看后端容器所在网络
docker inspect <backend-container-name> | grep Networks
# 查看数据库容器所在网络
docker inspect database | grep Networks

正常情况下，两者应该在同一个默认网络（比如your-project-name_default）。如果不在，检查docker-compose.yml是否手动指定了不同网络。

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