Docker容器环境下EF Core更新数据库失败，求解决方案

1. 确认数据库容器的SA密码配置 #

检查你的docker-compose.yml中SQL Server服务的环境变量，必须设置符合复杂度要求的SA密码（至少8位，包含大小写字母、数字、特殊字符），示例配置如下：

services:
  db:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      - SA_PASSWORD=YourStrong!Passw0rd
      - ACCEPT_EULA=Y
    ports:
      - "1433:1433"

密码不符合要求会导致数据库容器启动失败，直接引发连接问题。

2. 校验API容器的连接字符串 #

容器间通信必须使用docker-compose中数据库服务的名称（比如示例中的db）作为服务器地址，不能用localhost。连接字符串示例：

Server=db;Database=你的数据库名;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True;

• 确认Program.cs中正确读取连接字符串：

  builder.Services.AddDbContext<你的DbContext>(options =>
      options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
  

• 确认docker-compose.yml中API服务的环境变量正确传递连接字符串：

  api:
    build: .
    environment:
      - ConnectionStrings__DefaultConnection=Server=db;Database=你的数据库名;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True;
    depends_on:
      - db
  

3. 禁止在Dockerfile中执行RUN dotnet ef database update #

Dockerfile的RUN命令是构建镜像时执行的，此时数据库容器尚未启动，无法建立连接，必然报错。数据库更新必须放在容器启动后执行。

4. 正确执行数据库更新的两种方法 #

方法一：进入API容器内部执行 #

1. 启动所有容器并后台运行：docker-compose up -d
2. 查看API容器名称：docker ps
3. 进入容器终端：docker exec -it <你的API容器名称> bash
4. 切换到项目目录后执行更新：dotnet ef database update
   若不在项目根目录，可指定项目路径：dotnet ef database update --project ./你的API项目文件夹

方法二：宿主机直接连接容器内数据库执行 #

确保数据库容器的1433端口已映射到宿主机，直接在宿主机终端运行：

dotnet ef database update --connection "Server=localhost;Database=你的数据库名;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True;"

5. 等待数据库容器完全就绪 #

SQL Server容器启动需要一定时间，立即执行更新可能因数据库未就绪失败。可手动等待容器状态变为healthy（通过docker ps查看），或在docker-compose.yml中配置健康检查，让API容器等待数据库就绪后再启动。

内容的提问来源于stack exchange，提问作者Jakub Łuka