Visual Studio中Database First模式下如何迁移其他开发者的数据库变更至本地

前置操作 #

不管用哪种同步方式，第一步先完成这几项准备：

• 从版本控制系统拉取远端最新代码，确保本地拿到协作者提交的所有迁移文件、模型文件、SQL脚本，不要遗漏任何变更项。
• 确认本地项目的数据库连接字符串指向自己的本地开发数据库，严禁误连测试、生产环境。
• 备份本地开发库，避免同步出错丢失测试数据。

场景1：项目使用EF标准迁移流程（EF Core/EF6 通用） #

这是目前团队协作最常用的流程，操作步骤：

1. 打开VS顶部菜单「视图」-「其他窗口」-「包管理器控制台」，把控制台顶部的「默认项目」下拉选项，选中项目里存放DbContext数据库上下文、迁移文件的类库项目。
2. 执行Get-Migration命令，查看本地待应用的迁移列表，确认协作者新提交的迁移条目在列表里，状态显示为Pending（待应用）。
3. 直接执行Update-Database命令，EF会自动按迁移提交的时间顺序，把所有未在本地库执行过的变更依次执行，完成结构同步。
4. 同步完成后可以通过VS的SQL Server对象资源管理器连接本地库，核对新增的表、字段、索引、存储过程是否符合预期，再启动项目跑核心流程验证没有模型映射报错即可。

如果你用的是EF Core的Database First反向工程模式，协作者提交完库结构变更、你同步完本地库结构之后，也可以直接执行Scaffold-DbContext "你的本地库连接字符串" Microsoft.EntityFrameworkCore.SqlServer -Force -Context 你的DbContext名称命令，直接强制重新生成和最新库结构匹配的实体类和DbContext代码。

场景2：项目使用EDMX模型（仅EF6及更早版本）/ 协作者提交增量SQL脚本 #

如果是老项目用EDMX可视化模型，或者团队约定直接提交SQL增量脚本同步，按以下步骤操作：

1. 找到协作者提交的对应版本增量SQL脚本（不要用全量建库脚本），在本地数据库上逐段执行，遇到字段冲突、约束冲突类报错不要硬改脚本，先和提交脚本的协作者确认变更逻辑，对齐后再继续执行。
2. 本地库结构更新完成后，打开项目里的.edmx模型文件，右键点击设计器空白处，先选「验证」检查模型加载有没有错误，没有报错的话选择「从数据库更新模型」，在弹窗里勾选本地库新增的表、字段、外键关联，点击完成后VS会自动更新EDMX模型和对应的C#实体类代码。
3. 重新生成整个解决方案，检查有没有实体类字段不匹配的编译报错，有报错核对字段类型、名称和本地库结构一致即可。

常见踩坑说明 #

• 执行Update-Database如果报“对象已存在”“约束冲突”类错误，不要直接修改协作者提交的迁移文件，先确认是你本地之前私自改了库结构没走迁移流程，还是协作者提交的迁移没做兼容判断，对齐逻辑后再处理。
• 如果同步完启动项目报“上下文模型和数据库结构不匹配”的错误，可以临时执行Add-Migration SyncCheck生成一个检查用的空迁移：如果生成的迁移文件Up和Down方法是空的，说明结构已经对齐，直接删掉这个临时迁移即可；如果生成了多余的变更代码，说明本地库结构和迁移记录不一致，核对清楚差异项再调整。
• 不要随便用Update-Database -Force之类的强制参数，很容易丢失本地测试数据。

内容的提问来源于stack exchange，提问作者Mohottige Chamil Asanka