EF Core中如何更新.designer.cs与快照文件以包含手动生成表

背景 #

EF Core提供了MigrationBuilder.CreateTable()方法，可用于手动添加DbContext中不存在的表。同时，EF Core的每个迁移都有自动生成的.Designer.cs文件（包含EF使用的元数据）和...DbContextModelSnapshot.cs文件，二者均通过dotnet ef migrations add命令自动生成。

问题 #

修改DbContext（比如添加新的DbSet<SomeClass>）并执行dotnet ef migrations add生成迁移时，设计器文件和快照文件会同步包含新表的信息；但如果先创建空迁移，再手动调用CreateTable()添加DbContext中不存在的表，这两个文件不会包含该表的信息。另外，在迁移中执行任意原始SQL也会出现同样的问题。官方文档仅提及重新生成的思路，但EF CLI没有强制重新生成的选项。

疑问与解答 #

1. 表存在于迁移和数据库中，但未出现在设计器和快照文件中，是否有影响？ #

会产生明确影响：

• 后续迁移生成异常：EF Core生成新迁移时，核心逻辑是对比当前DbContext模型与快照文件记录的模型状态。如果快照里没有手动添加的表，EF会误判这些表不存在，后续生成迁移时可能尝试重复创建表，或者在模型对比阶段抛出不一致的错误。
• 工具支持失效：部分EF Core工具（如模型可视化工具、dotnet ef dbcontext scaffold）依赖快照文件识别数据库的完整模型结构，缺失表信息会导致这些工具无法正常工作。

2. EF Core(v8)实际使用这些文件做什么？ #

• .Designer.cs文件：每个迁移的设计器文件存储了该迁移对应的模型快照，以及迁移元数据（如迁移ID、创建时间、关联的DbContext类型等）。EF应用迁移时会验证这些元数据的适用性，回滚迁移时也依赖该文件记录的模型状态生成回滚逻辑。
• ...DbContextModelSnapshot.cs文件：这是当前DbContext对应的最新模型状态快照，是EF Core生成增量迁移的核心依据。每次执行dotnet ef migrations add时，EF会对比当前DbContext模型与该快照的差异，自动生成对应的迁移代码。没有这个快照，EF无法计算模型变化，也就无法生成自动迁移。

3. 如何重新生成这些文件以确保状态准确（若可行）？ #

EF CLI没有直接强制重新生成的选项，可通过以下步骤手动同步状态：

• 备份所有现有迁移文件（包括.cs、.Designer.cs和快照文件），避免丢失手动修改的内容。
• 删除所有现有迁移文件和快照文件。
• 执行dotnet ef migrations add InitialCreate（命名可自定义），基于当前DbContext模型生成全新的迁移和快照文件。
• 将之前手动添加的CreateTable()、原始SQL等逻辑，合并到新生成的迁移文件中。
• 执行dotnet ef database update，确保数据库状态与新的迁移、快照一致。

注意：该方法相当于重置迁移历史，更适合开发阶段或允许重置数据库的场景。生产环境下建议先备份数据库，再通过手动编辑快照文件补全表信息（需熟悉EF Core模型元数据结构，操作需谨慎）。

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