ASP MVC项目本地开发及服务器部署的EF迁移最佳实践

嘿，我来帮你搞定EF Migrations在本地开发到服务器部署时的数据库变更问题，这是很多开发者都会踩的坑，给你梳理一套靠谱的最佳实践：

一、先把核心原则记牢 #

• 永远别手动修改Migrations文件夹里的迁移文件，也别碰数据库里的__EFMigrationsHistory表——这俩是EF Migrations的“账本”，改了必出冲突
• 本地和服务器必须用完全相同的迁移序列：本地生成的迁移文件要同步到代码仓库，部署时在服务器上执行这些现成的迁移，绝对不能在服务器上重新生成迁移

二、本地开发的正确姿势 #

1. 每次改数据库前，先确保本地数据库是最新状态：执行Update-Database（Package Manager Console）或者dotnet ef database update（CLI）
2. 修改实体类或DbContext配置后，生成清晰命名的迁移：
   • PMC命令：Add-Migration AddUserBirthdayField（名字要一眼看出做了啥，比如加了用户生日字段）
   • CLI命令：dotnet ef migrations add AddUserBirthdayField
3. 本地执行迁移验证效果：Update-Database或dotnet ef database update
4. 把Migrations文件夹下生成的.cs和.Designer.cs文件提交到代码仓库——这是后续部署的关键，丢了就麻烦了

三、部署到服务器的正确步骤 #

初次部署 #

1. 先确保服务器上的目标数据库已经创建（空库就行）
2. 执行迁移的两种方式：
   • 自动执行（不推荐生产环境）：在Program.cs里加一段启动时自动迁移的代码，适合测试环境：

     using (var scope = app.Services.CreateScope())
     {
         var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
         dbContext.Database.Migrate();
     }
     

   • 手动执行（生产环境首选）：发布项目后，在服务器上运行CLI命令：

     dotnet ef database update --connection "Server=你的服务器地址;Initial Catalog=SomethingDB;User ID=xxx;Password=xxx;MultipleActiveResultSets=True;"
     

   • 或者如果你能通过PMC连接到服务器数据库，直接用Update-Database -Connection "服务器连接字符串"

后续更新（已有数据的情况） #

1. 本地完成变更、生成迁移、验证没问题后，把迁移文件提交到代码仓库
2. 部署新版本到服务器时，绝对别在服务器上生成新迁移，直接执行dotnet ef database update（确保服务器项目里已经同步了最新的迁移文件）
3. 这样服务器的__EFMigrationsHistory表会和本地完全同步，不会出现“找不到迁移记录”的报错

四、已经出现迁移历史不一致？这么修复 #

如果已经踩坑，本地和服务器的迁移对不上了，按这个步骤来（先备份服务器数据库！先备份！先备份！）：

1. 查看服务器__EFMigrationsHistory表的所有记录，找到最后一条和本地匹配的迁移名称
2. 本地删除所有在这条记录之后生成的迁移文件（别改历史迁移，直接删新的）
3. 本地回滚到匹配的状态：Update-Database 最后匹配的迁移名称
4. 重新基于当前实体类生成新的迁移，提交到仓库，然后在服务器上执行这个新迁移
5. 如果情况特别糟（比如服务器手动改过迁移记录），最稳妥的方式：
   • 导出服务器数据库的所有数据
   • 清空服务器数据库，删掉__EFMigrationsHistory表
   • 本地执行所有迁移到最新状态，然后把导出的数据导入服务器（注意数据要和新表结构兼容）

五、已有数据时修改数据库的注意事项 #

• 添加新字段时，尽量设为可空（比如public string? NewField { get; set; }）或者给默认值，不然迁移时会因为现有数据没有值报错
• 修改已有字段类型/约束前，先检查现有数据能不能兼容（比如把string长度从50改到100没问题，但从100改到50可能会截断数据）
• 删除字段前，确认没有业务代码依赖它，并且备份好相关数据
• 复杂变更（比如拆分表、合并表）建议拆成多次小迁移，每次只做一个变更，确保每次迁移都能顺利执行

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