Blazor WebServer项目Docker部署下自动执行Code First迁移问题

一、生产环境执行Code First迁移的几种实用方法 #

1. 应用启动时自动跑迁移 #

这是最省心的方式，直接在Program.cs里加一段代码，启动时自动检查并应用所有未执行的迁移：

var app = builder.Build();

// 处理Blazor项目管理的数据库迁移
using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<你的DbContext类>();
    dbContext.Database.Migrate(); // 数据库不存在会自动创建，同时应用所有迁移
}

// 后面正常配置中间件
app.Run();

只要容器内的应用能正常连接SQL Server容器，这个逻辑就能自动完成迁移工作，无需手动干预。

2. 用Docker Compose手动执行迁移 #

如果不想让迁移和应用启动绑定，或者需要单独调试迁移，可以启动临时容器执行命令：

• 先确保SQL Server容器已启动：docker-compose up -d sqlserver
• 再执行迁移命令（替换成你的服务名、项目名和上下文类）：

docker-compose run --rm 你的Blazor服务名 dotnet ef database update --project 你的Blazor项目名 --context 你的DbContext类

这个命令会启动临时应用容器，跑完迁移后自动销毁，不影响现有服务。

3. 把EF工具打包进容器镜像 #

如果需要在容器内随时执行迁移操作，可以在Dockerfile里预先安装EF Core工具：

RUN dotnet tool install --global dotnet-ef
ENV PATH="$PATH:/root/.dotnet/tools"

这样后续不管是启动容器前跑迁移，还是进入容器手动执行命令都能正常操作。

二、数据库自动生成的问题 #

答案是肯定的：当数据库不存在、且应用连接字符串正确指向SQL Server时，调用dbContext.Database.Migrate()会自动创建数据库，同时把所有迁移都应用完成。

如果只想创建数据库但不应用迁移，可以用dbContext.Database.EnsureCreated()，但注意这个方法和迁移体系不兼容，后续无法用迁移更新数据库结构，生产环境优先推荐用Migrate()。

三、多数据库的处理（DDL脚本 + Blazor迁移） #

针对用.ddl文件管理的数据库，你可以让SQL Server容器启动时自动执行脚本：
在docker-compose.yml的sqlserver服务里添加卷挂载，把你的DDL脚本放到容器的/docker-entrypoint-initdb.d/目录下——SQL Server容器第一次启动（数据卷为空）时，会自动执行该目录下的所有.sql脚本：

services:
  sqlserver:
    image: mcr.microsoft.com/mssql/server:2022-latest
    volumes:
      - ./本地DDL脚本路径:/docker-entrypoint-initdb.d/
    environment:
      SA_PASSWORD: "你的强密码"
      ACCEPT_EULA: "Y"

至于Blazor项目管理的数据库，用前面提到的Migrate()方法处理即可，记得给两个数据库配置不同的连接字符串，让各自的DbContext指向正确的库。

内容的提问来源于stack exchange，提问作者Steven Gazo M.