.NET Web API容器通过EF Core连接Docker MySQL容器失败求助

问题梳理 #

核心问题分为两点：

1. 本地执行update-database时，无法通过容器名mysql-container连接Docker中的MySQL（本地环境不在Docker专属网络内）；
2. Docker Compose启动时未自动执行EF迁移，且服务启动顺序未保证MySQL完全就绪，导致API无法连接数据库。

解决方案 #

1. 修正Docker Compose中的MySQL数据目录错误

你的docker-compose.yml中MySQL的volume路径多了一个l，这会导致MySQL容器无法正常初始化数据目录，修正如下：

database:
  image: mysql:latest
  container_name: mysql-container
  ports:
    - "3306:3306"
  expose: 
    - 3306
  volumes:
    - db-volume:/var/lib/mysql  # 将/var/lib/mysqll改为/var/lib/mysql
  restart: always
  environment: 
    MYSQL_ROOT_PASSWORD: root
    MYSQL_USER: mysqlDbUser
    MYSQL_PASSWORD: mysqlDbPass#
    MYSQL_DATABASE: UserAPI

2. 本地开发时调整连接字符串

本地机器不在Docker默认网络中，无法通过容器名访问数据库，需为开发环境单独配置连接信息：

• 创建appsettings.Development.json文件，覆盖生产环境的连接字符串：

{
  "ConnectionStrings": {
    "MySqlConnection": "Server=localhost;port=3306;User ID=mysqlDbUser;Password=mysqlDbPass#;Database=UserAPI"
  }
}

此时本地执行update-database，会通过localhost连接Docker映射到本地的3306端口，即可正常访问数据库。

3. 配置Docker Compose服务依赖

确保Web API服务在MySQL之后启动，添加depends_on配置：

userapi:
  image: ${DOCKER_REGISTRY-}userapi
  build:
    context: .
    dockerfile: UserAPI/Dockerfile
  depends_on:
    - database  # 保证database服务先启动
  ports:
    - "5000:80"  # 可选：映射端口以便本地访问API

4. 让API容器自动执行EF迁移

避免本地与容器环境的连接差异，在API启动时自动应用迁移：
在Program.cs中添加迁移逻辑：

var app = builder.Build();

// ... 保留原有中间件配置（如Swagger、路由等） ...

// 自动应用数据库迁移
using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;
    try
    {
        var dbContext = services.GetRequiredService<UserContext>();
        dbContext.Database.Migrate();
    }
    catch (Exception ex)
    {
        var logger = services.GetRequiredService<ILogger<Program>>();
        logger.LogError(ex, "数据库迁移执行失败");
    }
}

app.Run();

5. 添加数据库连接重试逻辑

MySQL容器启动需要时间，depends_on仅保证启动顺序，无法确保服务就绪，可在DbContext配置中添加重试：

builder.Services.AddDbContext<UserContext>(options => 
    options.UseMySql(
        builder.Configuration.GetConnectionString("MySqlConnection"), 
        ServerVersion.AutoDetect(builder.Configuration.GetConnectionString("MySqlConnection")))
    .EnableRetryOnFailure());  // 连接失败时自动重试

验证步骤 #

1. 启动Docker Compose：docker-compose up -d；
2. 查看容器日志确认服务正常启动：docker-compose logs -f；
3. 访问API接口，验证数据库读写功能是否正常。

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