EntityFramework Core 9.0 迁移中的 PendingModelChangesWarning 问题解析

问题现象

在 EntityFramework Core 9.0 版本中，开发者在执行数据库迁移时遇到了一个常见问题：当尝试通过 dotnet ef database update 命令更新数据库时，系统会抛出 PendingModelChangesWarning 异常，提示模型存在待处理的更改，需要先添加新的迁移。

典型错误信息如下：

System.InvalidOperationException: An error was generated for warning 'Microsoft.EntityFrameworkCore.Migrations.PendingModelChangesWarning': The model for context 'AccountSqliteDbContext' has pending changes. Add a new migration before updating the database.

问题背景

这个问题首次在 EF Core 8.0.10 版本中被报告，并在 9.0.0 版本中依然存在。它主要出现在以下场景中：

1. 使用 OwnsMany 配置实体关系时
2. 在多项目解决方案中（Domain/Infrastructure分离架构）
3. 当模型配置中包含数据种子（HasData）时

问题重现步骤

1. 创建包含 Domain 和 Infrastructure 层的多项目解决方案
2. 在 Domain 项目中定义实体模型
3. 在 Infrastructure 项目中配置 DbContext 和实体关系（特别是使用 OwnsMany）
4. 执行 dotnet ef migrations add InitialCreate 创建初始迁移
5. 执行 dotnet ef database update 更新数据库

技术分析

根本原因

经过分析，这个问题源于 EF Core 9.0 在模型比较机制上的一个缺陷。当存在以下情况时，模型比较会出现误判：

1. 动态生成的种子数据：当使用 DateTime.Now、Guid.NewGuid 等动态方法生成种子数据时，每次模型比较都会认为模型发生了变化。

2. OwnsMany 配置：在某些多项目结构中，OwnsMany 关系的配置会导致模型比较不一致。

3. 外键约束变化：从错误迁移中可以看到，问题与外键约束的级联删除行为有关。

典型错误迁移

当开发者尝试添加第二个迁移时，EF Core 会生成一个实际上不应该存在的迁移，内容通常涉及外键约束的修改：

public partial class Two : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropForeignKey(
            name: "FK_account_holder_account_account_id",
            table: "account_holder");

        migrationBuilder.AddForeignKey(
            name: "FK_account_holder_account_account_id",
            table: "account_holder",
            column: "account_id",
            principalTable: "account",
            principalColumn: "id");
    }
}

解决方案

临时解决方案

1. 忽略警告：在 DbContext 配置中添加以下代码忽略特定警告：

   options.ConfigureWarnings(warnings => 
       warnings.Ignore(RelationalEventId.PendingModelChangesWarning));
   

2. 降级到 EF Core 8：如果项目允许，暂时降级到 EF Core 8.0 版本。

3. 静态种子数据：避免在 HasData 中使用动态生成的值，改用静态数据。

长期解决方案

等待 EF Core 团队修复以下问题：

1. 模型比较机制对动态种子数据的处理
2. 多项目结构中 OwnsMany 配置的稳定性
3. 外键约束变化的正确检测

最佳实践建议

1. 迁移工作流：在执行 database update 前，始终先执行 migrations add 并检查生成的迁移内容。

2. 种子数据分离：考虑将种子数据逻辑从迁移中分离，使用单独的初始化脚本或应用启动时的数据填充。

3. 环境隔离：在开发环境中启用详细的迁移日志，帮助诊断问题。

4. 版本控制：在团队开发中，确保所有成员使用相同版本的 EF Core 工具和运行时。

总结

EF Core 9.0 中的这个迁移问题主要影响多项目结构和复杂实体关系的场景。开发者可以通过上述临时解决方案缓解问题，同时关注 EF Core 团队的官方修复进展。理解这个问题背后的技术原因有助于开发者更好地规划项目结构和迁移策略，避免类似问题的发生。