Docker容器化ASP.NET Core+MySQL应用时连接db服务器数据库报错如何解决

An error occurred using the connection to database '' on server 'db'. - Docker

报错原因 #

1. 依赖包版本不兼容：你当前使用的Pomelo.EntityFrameworkCore.MySql 5.0.1版本适配的是.NET 5/EF Core 5及以上版本，而你的项目是ASP.NET Core 3.1，版本不匹配会导致连接字符串解析异常，出现数据库名为空的报错。
2. 缺少MySQL版本声明：Pomelo.EntityFrameworkCore.MySql 3.x及以上版本要求调用UseMySql时必须显式指定MySQL的版本号，未指定会导致连接初始化失败。
3. 容器启动顺序问题：docker-compose.yaml中的depends_on仅控制服务启动顺序，不会等待MySQL服务完全初始化完成、可以接受连接后再启动后端服务，MySQL未就绪时发起连接请求也会触发报错。
4. 目标数据库不存在：你连接字符串中指定的数据库名为MySqlDbContext，如果MySQL初始化后没有手动创建该库，也没有配置EF Core自动迁移建库，会导致连接失败。

解决方案 #

1. 调整依赖包版本 #

将Pomelo.EntityFrameworkCore.MySql降级到适配.NET Core 3.1的3.x版本，比如3.2.4：

Install-Package Pomelo.EntityFrameworkCore.MySql -Version 3.2.4

2. 修正Startup.cs中的数据库配置 #

显式传入你使用的MySQL 5.7.22版本参数：

public void ConfigureServices(IServiceCollection services)
{
 services.AddDbContext<MySqlDbContext>(
                    options => options.UseMySql(
                        Configuration.GetConnectionString("MySql"),
                        // 显式指定MySQL版本
                        new MySqlServerVersion(new Version(5,7,22)),
                        mySqlOptionsAction => mySqlOptionsAction.EnableRetryOnFailure()
                    ));
}

3. 调整docker-compose配置，解决启动顺序问题 #

给web服务添加失败自动重启配置，兼容性更强：

version: '2'
services:
  db:
    container_name: hello.db
    image: mysql:5.7.22
    environment:
      MYSQL_ROOT_PASSWORD: 123456
    volumes:
      - ./mysql:/var/lib/mysql

  web:
    container_name: hello.web
    build: .
    depends_on:
      - db
    links:
      - db
    # 启动失败自动重试，直到MySQL就绪连接成功
    restart: on-failure

4. 初始化目标数据库 #

二选一即可：

• 手动进入MySQL容器创建MySqlDbContext数据库
• 在ASP.NET Core项目中添加自动迁移逻辑，在Startup.cs的Configure方法中添加如下代码，启动时自动建库建表：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env, MySqlDbContext context)
{
    // 自动执行迁移，创建库和表
    context.Database.Migrate();
    // 原有其他配置保持不变
}

可选优化 #

你当前的Dockerfile使用SDK镜像执行dotnet run属于开发模式，性能较低，建议改为多阶段构建使用runtime镜像运行：

FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS build
WORKDIR /src
COPY . .
RUN dotnet restore
RUN dotnet publish -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 AS runtime
WORKDIR /app
COPY --from=build /app/publish .
EXPOSE 5000
ENV ASPNETCORE_URLS http://*:5000
ENTRYPOINT ["dotnet","你的项目名称.dll"]

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