使用Docker Compose部署MySQL与ASP.NET应用时连接失败问题

1. 确认连接字符串的主机名配置 #

docker-compose 中服务名是容器间的 DNS 别名，绝对不能用 localhost 或 127.0.0.1，必须使用 docker-compose.yml 中 MySQL 服务的名称。比如 MySQL 服务名为 mysql-db，连接字符串应写为：

Server=mysql-db;Port=3306;Database=YourDbName;Uid=root;Pwd=YourPassword;

（ASP.NET 容器内的 localhost 指向容器自身，而非 MySQL 容器）

2. 确保 MySQL 就绪后再启动 ASP.NET 容器 #

MySQL 容器启动后需要完成初始化流程，ASP.NET 容器可能在 MySQL 未就绪时发起连接导致超时。在 docker-compose.yml 中添加依赖和健康检查：

services:
  aspnet-app:
    build: .
    depends_on:
      mysql-db:
        condition: service_healthy
    ports:
      - "5000:80"
  mysql-db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_root_pwd
      MYSQL_DATABASE: your_target_db
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

3. 检查 MySQL 绑定地址配置 #

确保 MySQL 容器未限制仅本地连接，默认 mysql 镜像已配置 bind-address = 0.0.0.0，如果自定义了 my.cnf，需确认该参数未被修改为 127.0.0.1。

4. 优化连接字符串参数 #

• 核对端口号、用户名、密码、数据库名与 docker-compose 环境变量完全匹配
• 适当延长连接超时时间，避免初始化延迟导致的超时：

Server=mysql-db;Port=3306;Database=YourDbName;Uid=root;Pwd=YourPassword;Connection Timeout=30;

5. 验证 DbContext 配置正确性 #

确认 Program.cs 中 DbContext 正确读取连接字符串并使用对应 MySQL 版本：

builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseMySql(
        builder.Configuration.GetConnectionString("DefaultConnection"),
        new MySqlServerVersion(new Version(8, 0, 33))
    )
);

同时检查 appsettings.json 或环境变量中的 DefaultConnection 配置无误。

6. 查看容器日志定位细节 #

• 查看 MySQL 容器日志，确认是否有权限或初始化异常：

docker-compose logs mysql-db

• 查看 ASP.NET 容器日志，获取更具体的连接错误信息：

docker-compose logs aspnet-app

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