如何使Entity Framework Core模型与直接修改后的数据库保持一致？

我正在开发一个使用Entity Framework Core的项目。近期，同事直接修改了数据库（未通过EF），而我之前已经更新过EF模型以匹配原数据库架构。现在EF模型和数据库实际状态不一致，我需要更新模型来匹配当前数据库，但不知道该怎么做。

我已经做了这些步骤：

• 安装了必要的EF工具
• 尝试用dotnet ef dbcontext scaffold命令重新生成DbContext和实体类

我在Stack Overflow上看到一个回答，建议修改POCO、构建迁移，然后在PowerShell中用-Script参数执行命令：

Update-Database -Script -Force -ProjectName 'MyProject'

这个命令会生成变更SQL脚本，允许只执行向MigrationHistory表插入行的部分，让EF感知到变更。但我用dotnet ef工具加--script选项时，收到错误：

PS C:\repos\Fetchit.Orion\FetchitOrion> dotnet ef database update --script 
Build started...
Build succeeded.
Specify --help for a list of available options and commands.
Unrecognized option '--script'

看来dotnet ef不支持--script选项。

我的问题：

1. 直接修改数据库后，协调Entity Framework模型与数据库的最佳方法是什么？
2. 使用dotnet ef dbcontext scaffold时，是否有特定命令或选项可确保捕获所有变更？
3. 如何有效合并Entity Framework模型中的现有配置和关系与更新后的数据库架构？

1. 协调EF模型与数据库的最佳方法 #

有两种主流方案，可根据团队工作流选择：

• 反向工程重置模型
  如果你的模型以数据库驱动为主（无大量自定义EF配置），直接用反向工程重新生成整个模型和DbContext是最直接的方式，能确保模型100%匹配当前数据库。但会覆盖现有模型文件，操作前需做好备份或版本控制。

• 空白迁移同步迁移历史
  若不想覆盖现有模型，可手动调整模型后同步迁移记录：

  1. 手动修改EF模型（实体类、Fluent API配置），确保与当前数据库完全一致
  2. 生成空白迁移：dotnet ef migrations add <MigrationName> --empty
  3. 打开迁移文件，清空Up和Down方法（数据库已是最新状态，无需执行变更）
  4. 执行命令标记迁移为已应用：dotnet ef database update
     这样EF的迁移历史就会与数据库状态对齐，后续迁移可正常基于当前状态生成。

  注意：你看到的Update-Database -Script是Package Manager Console（PMC）的命令，并非dotnet ef CLI命令。CLI中生成脚本的对应命令是dotnet ef migrations script，但同步迁移历史用空白迁移的方式更直接。

2. 确保Scaffold捕获所有变更的选项 #

使用dotnet ef dbcontext scaffold时，添加以下选项可确保捕获完整的数据库元素：

• -d/--data-annotations：用数据注解而非Fluent API配置模型，适合简单场景
• -c/--context：指定生成的DbContext名称，避免默认命名冲突
• -t/--table：若只需更新特定表，可多次使用该选项指定多个表，默认生成所有表
• -s/--schema：数据库使用自定义schema时，指定对应schema名称，避免遗漏该schema下的表
• --no-onconfiguring：已有自定义DbContext配置（如连接字符串）时，添加此选项可避免生成默认的OnConfiguring方法
• --force：强制覆盖现有模型文件，确保新生成内容完全替换旧文件

示例命令：

dotnet ef dbcontext scaffold "Server=.;Database=MyDb;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -c MyDbContext -d --force

3. 合并现有配置与更新后架构的方法 #

若现有模型包含大量自定义配置（如Fluent API关系配置、索引、验证规则），直接scaffold会覆盖这些配置，需手动合并：

• 备份现有模型：执行scaffold前，将现有实体类、DbContext文件复制到临时目录，或用版本控制创建分支，方便后续对比差异
• 生成新模型：用--force选项生成新的模型文件
• 对比差异：用代码对比工具（如VS差异对比、Beyond Compare）找出新模型中新增/修改的字段、表、关系
• 迁移自定义配置：将现有模型中的自定义配置（如HasOne/WithMany关系、HasIndex索引、IsRequired验证等）迁移到新模型中。建议将Fluent API配置放在单独的IEntityTypeConfiguration类中，scaffold不会覆盖这类独立配置文件
• 测试验证：运行项目，测试数据库操作是否正常，确保所有配置生效且模型与数据库完全匹配

另外，建议团队后续约定：所有数据库变更必须通过EF迁移执行，避免直接修改数据库，从根源上避免模型与数据库不一致的问题。

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