恢复MSSQL数据库后，.NET6 Web API中EF无法添加新实体的问题

问题原因 #

你遇到的错误本质是EF Core的迁移跟踪与恢复后数据库的实际状态不匹配：

• 步骤3生成的空数据库带有新的initial迁移记录，而步骤5的恢复操作将数据库替换为备份版本，其__EFMigrationsHistory表记录的是备份时的迁移历史。
• 后续生成新迁移时，EF认为当前数据库处于initial状态，尝试创建已存在的表/对象，因此抛出There is already an object named 'xxx' in the database错误。

解决方案 #

方案1：同步迁移历史记录 #

1. 在SSMS中打开恢复后的数据库，查询__EFMigrationsHistory表，获取最后一条记录的MigrationId。
2. 在Visual Studio的Package Manager Console中执行命令：

   Update-Database -Migration <获取到的MigrationId>
   

   该命令会让EF Core将本地迁移状态与数据库的实际迁移历史同步。
3. 之后修改实体，正常执行Add-Migration <新迁移名称>和Update-Database即可。

方案2：重新初始化迁移跟踪 #

如果不需要保留原备份的迁移历史，可以重置迁移跟踪：

1. 在SSMS中删除恢复后数据库里的__EFMigrationsHistory表。
2. 在Visual Studio中删除所有现有迁移文件（包括ContextModelSnapshot.cs）。
3. 执行命令生成空的初始迁移，标记当前数据库结构与模型匹配：

   Add-Migration Initial -IgnoreChanges
   

4. 执行Update-Database，EF Core会重新创建__EFMigrationsHistory表并记录当前迁移状态。
5. 后续修改实体后，正常执行迁移命令即可。

方案3：优化数据库恢复流程（避免问题重演） #

下次恢复数据库时，跳过先创建空数据库的步骤：

1. 在SSMS中直接将备份恢复到一个全新的数据库名称（而非先创建空库再覆盖）。
2. 修改项目的连接字符串，指向这个新恢复的数据库。
3. 在Visual Studio中执行Update-Database（无需提前创建迁移），EF Core会自动匹配数据库已有的迁移历史，后续开发即可正常使用迁移功能。

内容的提问来源于stack exchange，提问作者Michał Sawicki