Docker Compose下.NET Core Web API容器无法连接MySQL容器

针对你遇到的API容器无法连接MySQL，但phpMyAdmin可以正常连接的问题，以下是几个排查和解决方向：

1. 检查MySQL容器的绑定地址配置 #

自定义的MySQL Docker镜像可能默认将bind-address设为127.0.0.1，这会导致仅允许容器内部访问，同一Docker网络的其他容器无法连接。

修改你的DockerImg/db.Dockerfile，添加配置让MySQL监听所有地址：

# 假设MySQL配置文件路径为/etc/mysql/my.cnf，根据实际镜像调整
RUN echo "bind-address = 0.0.0.0" >> /etc/mysql/my.cnf

如果使用的是mysqld.cnf，则修改对应路径（比如/etc/mysql/mysql.conf.d/mysqld.cnf）。

2. 确保MySQL服务就绪后再启动API #

depends_on仅保证容器启动顺序，不确保MySQL服务完全初始化完成。API可能在MySQL还没准备好时发起连接，导致失败。

方案A：使用健康检查配合depends_on（推荐） #

在docker-compose.yml的db服务中添加健康检查，让API等待MySQL就绪后再启动：

db:
    build:
        context: .
        dockerfile: DockerImg/db.Dockerfile
    container_name: armedia-db
    volumes:
        - "./DockerImg/db:/var/lib/mysql"
    environment:
        - MYSQL_USER=root
        - MYSQL_ROOT_PASSWORD=******
        - MYSQL_DATABASE=armedia
    healthcheck:
        test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
        interval: 5s
        timeout: 5s
        retries: 5

同时修改api服务的depends_on：

api:
    build:
        context: .
        dockerfile: Dockerfile
    container_name: armedia-api
    ports:
        - 8082:80
    links:
        - db
    depends_on:
        db:
            condition: service_healthy
    env_file:
        - DockerImg/dbarmedia.env
    environment:
        - DBHOST=db

方案B：使用等待脚本 #

在API的Dockerfile中添加wait-for-it脚本，让API等待MySQL端口开放后再启动：

ADD https://raw.githubusercontent.com/vishnubob/wait-for-it/master/wait-for-it.sh /wait-for-it.sh
RUN chmod +x /wait-for-it.sh
# 替换成你的API启动命令，比如dotnet项目
CMD ["/wait-for-it.sh", "db:3306", "--", "dotnet", "YourApiAssembly.dll"]

3. 调整API连接字符串细节 #

如果是.NET API，检查以下几点：

• 连接字符串添加SslMode=None（若MySQL容器未配置SSL）：

  {
    "ConnectionStrings": {
        "Default": "Server=db;Port=3306;Uid=root;Pwd=******;Database=armedia;SslMode=None;"
    }
  }
  

• 确认使用的MySqlConnector NuGet包版本与MySQL容器版本兼容，避免因认证方式不匹配导致连接失败。
• 仔细核对连接字符串中的密码，确保与db服务的MYSQL_ROOT_PASSWORD完全一致。

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

进入API容器，手动测试与MySQL容器的连通性：

# 测试域名解析
docker exec -it armedia-api ping db
# 测试3306端口是否开放
docker exec -it armedia-api telnet db 3306
# 或使用nc（若容器内已安装）
docker exec -it armedia-api nc -zv db 3306

如果ping通但端口不通，回到第一步检查MySQL的bind-address配置；如果ping不通，检查Docker Compose的网络配置（默认会创建桥接网络，所有服务默认加入同一网络）。

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