如何解决EF Core搭配Npgsql HiLo时的持续迁移错误？

问题分析 #

在EF Core 9.0中使用自定义名称的HiLo序列时，每次创建迁移都会生成删除默认序列EntityFrameworkHiLoSequence的脚本，即使模型快照中只包含自定义序列。这是因为EF Core的模型元数据中仍残留了默认HiLo序列的定义，导致迁移生成逻辑误判存在未处理的模型变更，进而触发运行时异常。

解决方案 #

在OnModelCreating方法中，显式标记默认名称的HiLo序列为已移除，让EF Core明确该序列不应存在于模型中。修改后的上下文配置代码如下：

public class XContext(DbContextOptions<XContext> options) : DbContext(options)
{
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        const string sequenceName = "EntityFrameworkHiLoSequenceXContext";
        
        // 显式移除默认的HiLo序列，避免迁移重复生成删除脚本
        modelBuilder.HasSequence<int>("EntityFrameworkHiLoSequence").IsRemoved();
        
        // 配置自定义HiLo序列
        modelBuilder.HasSequence<int>(sequenceName).IncrementsBy(5);
        // 全局使用自定义序列的HiLo策略
        modelBuilder.UseHiLo(sequenceName);
    }

    public DbSet<Item> Items { get; [UsedImplicitly] init; }
}

验证步骤 #

1. 执行dotnet ef migrations add FixSequenceIssue生成修复迁移，此时迁移脚本中不应再包含删除默认序列的操作。
2. 执行dotnet ef database update应用修复迁移。
3. 再次尝试创建空迁移（如dotnet ef migrations add VerifyFix），此时不会生成重复的删除默认序列的脚本，问题解决。

补充说明 #

• 该问题源于EF Core 9.0对模型变更检测的严格化，默认序列的残留元数据被误判为需要清理的变更。
• 显式调用IsRemoved()可以彻底从模型元数据中移除默认序列的定义，让迁移生成逻辑正确识别模型状态。

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