Docker部署ASP.NET Core 6.0 API无法连接MySQL主机求助

可能的问题及解决方案 #

1. 连接字符串未正确读取环境变量 #

确保API项目的连接字符串使用了docker-compose中定义的DBHOST环境变量，而非硬编码的localhost或其他地址：

• 在appsettings.Development.json中配置连接字符串：

  "ConnectionStrings": {
    "DefaultConnection": "Server=${DBHOST};Database=你的数据库名;User=root;Password=mat12345678;Port=3306;SslMode=None;"
  }
  

• 在Program.cs中添加环境变量读取逻辑：

  var builder = WebApplication.CreateBuilder(args);
  // 读取系统环境变量
  builder.Configuration.AddEnvironmentVariables();
  // 注册数据库上下文等服务...
  

2. MySQL容器未完全就绪API已启动 #

depends_on仅保证MySQL容器启动，但MySQL服务可能还未完成初始化。添加健康检查确保API在MySQL就绪后再启动：

修改docker-compose.yaml中的db服务配置：

db:
    image: mysql:8.0.0
    volumes:
      - datafiles:/var/lib/mysql  
    restart: always
    environment:
        MYSQL_ROOT_PASSWORD: mat12345678
        MYSQL_DATABASE: 你的数据库名 # 可选：自动创建指定数据库
        MYSQL_ROOT_HOST: "%" # 允许root远程连接
        MYSQL_INITDB_ARGS: "--default-authentication-plugin=mysql_native_password" # 兼容旧驱动
    healthcheck:
        test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-pmat12345678"]
        interval: 10s
        timeout: 5s
        retries: 5

修改api服务的depends_on配置：

api: 
 build:
    context: .
    dockerfile: Dockerfile
 depends_on: 
    db:
        condition: service_healthy # 等待MySQL健康检查通过
 ports:
    - "8888:80" 
 restart: always
 environment: 
    - DBHOST=db
    - ASPNETCORE_ENVIRONMENT=Development

3. MySQL 8.0认证插件兼容问题 #

MySQL 8.0默认使用caching_sha2_password认证插件，部分旧版本MySqlConnector可能不兼容，可通过两种方式解决：

• 在docker-compose.yaml的db环境变量中添加MYSQL_INITDB_ARGS: "--default-authentication-plugin=mysql_native_password"（如上配置）
• 更新项目中MySqlConnector NuGet包到最新版本

4. 验证Docker网络连通性 #

进入API容器，尝试ping MySQL服务名db确认网络连通：

# 查看API容器ID
docker ps
# 进入容器
docker exec -it <api-container-id> bash
# ping db服务
ping db

如果ping不通，检查docker-compose是否自动创建了默认网络（默认会创建，服务间可通过名称访问）。

验证步骤 #

1. 停止并删除现有容器：docker-compose down
2. 重新构建并启动：docker-compose up --build
3. 查看日志确认MySQL初始化完成：docker-compose logs db
4. 调用API接口测试连接

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