如何用Entity Framework Migrations为自定义类型新增枚举值

按以下步骤修复即可，枚举迁移不生成脚本是版本不匹配+配置错误共同导致的：

1. 对齐版本依赖 #

你当前运行时为.NET Core 3.1，但使用6.0.5版本的EF Core命令行工具，跨大版本的工具与运行时不兼容，会导致Npgsql迁移提供程序无法识别枚举类型差异。

• 降级全局dotnet-ef工具到匹配的3.1.x版本：

dotnet tool update --global dotnet-ef --version 3.1.32

• 确认项目引用的Npgsql.EntityFrameworkCore.PostgreSQL包版本为3.1.x系列，禁止使用5.x/6.x版本，避免兼容性问题。

2. 修正DbContext错误配置 #

当前两处配置会干扰枚举迁移识别，直接删除即可：

• 删除静态构造函数中NpgsqlConnection.GlobalTypeMapper.MapEnum<UserType>("user_type")代码：EF Core 3.1+版本的Npgsql不需要在静态构造中做全局枚举映射，混写会导致模型快照与运行时映射不一致。
• 删除OnModelCreating方法中modelBuilder.Entity<UserType>();代码：UserType是枚举类型而非实体，不需要注册为实体，该配置会误导迁移提供程序的类型识别逻辑。

修正后的枚举配置代码：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 仅保留这行枚举映射即可
    modelBuilder.ForNpgsqlHasEnum("user_type", new[] { "admin", "editor", "contributor" });
    // 其余实体配置保持不变
    modelBuilder.Entity<User>();
}

3. 重新生成迁移 #

之前错误配置生成的迁移快照已经记录了错误的模型状态，需要重新生成迁移：

1. 删除之前为添加contributor生成的无效迁移文件（包含Migrations目录下对应*.cs、*.Designer.cs文件）
2. 执行命令创建新迁移：

dotnet ef migrations add AddContributorToUserType

3. 校验新生成的迁移文件：.NET Core 3.1对应版本的Npgsql对枚举值新增的自动识别能力不完善，如果Up方法中没有自动生成枚举修改逻辑，手动添加如下SQL即可：

protected override void Up(MigrationBuilder migrationBuilder)
{
    // 加IF NOT EXISTS保证脚本幂等
    migrationBuilder.Sql("ALTER TYPE user_type ADD VALUE IF NOT EXISTS 'contributor';");
}

// 注意：PostgreSQL不支持直接删除枚举值，无强回滚需求可省略Down方法对应逻辑，需要回滚则要重建枚举类型重新赋值

4. 确认迁移内容无误后，再执行原有的幂等脚本生成命令，输出的SQL就会包含新增枚举值的语句。

补充 #

如果后续将项目运行时升级到.NET 5及以上，配合5.x+版本的Npgsql.EntityFrameworkCore.PostgreSQL，可自动识别枚举值新增、重命名等变更，不需要手动补充SQL。

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