Docker环境下ASP.NET Core无法连接MySQL数据库问题

问题概述 #

• ASP.NET Core项目通过Docker Compose部署，配置两个MySQL数据库服务（db1、db2）
• 执行docker-compose up -d后所有容器创建成功，但ASP.NET Core容器无法启动，错误日志提示无法连接MySQL主机db2
• 本地通过MySQL Workbench使用localhost:3307、localhost:3308可正常连接两个数据库，数据库已成功创建
• 多次修改连接字符串无效

排查与解决步骤 #

1. 确认Docker网络与主机名配置 #

• 确保ASP.NET Core服务和两个MySQL服务处于同一Docker网络（Docker Compose默认会创建专属网络，所有服务自动加入，若手动指定网络需统一）
• 连接字符串中的MySQL主机名必须使用Docker Compose中定义的服务名（如db2），而非localhost或本地IP——容器内部访问其他容器依赖服务名解析

2. 确保MySQL服务完全就绪后启动应用 #

MySQL容器创建后可能需要几秒初始化，ASP.NET Core启动过早会导致连接失败，可通过健康检查控制启动顺序：

services:
  webapp:
    # 其他配置...
    depends_on:
      db1:
        condition: service_healthy
      db2:
        condition: service_healthy

  db1:
    image: mysql:8.0
    # 其他配置...
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

  db2:
    image: mysql:8.0
    # 其他配置...
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

3. 修正连接字符串端口配置 #

容器内部访问MySQL需使用容器内部端口3306，而非宿主机映射的3307/3308，正确示例：

"ConnectionStrings": {
  "Db1Context": "server=db1;port=3306;database=Db1;user=root;password=your_password;",
  "Db2Context": "server=db2;port=3306;database=Db2;user=root;password=your_password;"
}

若使用MySQL 8.0，可添加SslMode=None避免SSL连接问题：

"Db2Context": "server=db2;port=3306;database=Db2;user=root;password=your_password;SslMode=None;"

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

进入ASP.NET Core容器测试与db2的连通性：

# 替换为你的ASP.NET Core容器名称
docker exec -it <webapp_container_name> bash

# 测试ping连通性
ping db2

# 测试3306端口是否可访问
telnet db2 3306

• 若ping不通：检查网络配置，确认服务在同一网络
• 若telnet不通：查看db2容器日志，确认MySQL是否监听0.0.0.0（默认配置）

5. 检查MySQL用户权限 #

确保MySQL用户（如root）允许从任意主机连接，而非仅限localhost：
在MySQL Workbench中执行：

ALTER USER 'root'@'%' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;

6. 查看完整错误日志 #

获取ASP.NET Core容器的详细错误信息，定位具体问题：

docker-compose logs <webapp_service_name>

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