Dotnet5+EF执行Postgres枚举迁移时报ALTER TYPE无法在事务块内运行错误

报错原因 #

PostgreSQL 本身存在语法限制：ALTER TYPE ... ADD VALUE 语句不允许在事务块内执行，而EF Core默认执行迁移时会全局开启事务，.NET 5对应版本的Npgsql EF Core提供程序自动生成的枚举修改迁移没有适配该限制，因此执行时会抛出 25001: ALTER TYPE ... ADD cannot run inside a transaction block 错误。

解决方案 #

方案1：执行迁移时临时禁用全局事务 #

仅需在执行迁移命令时追加禁用事务的参数即可，适合当前迁移仅包含枚举加值操作的场景：

• Package Manager Console 执行命令：
  Update-Database -NoTransaction
• dotnet CLI 执行命令：
  dotnet ef database update --no-transaction
  注意：该方案会禁用本次迁移所有操作的事务，若迁移包含其他修改操作，出错后不会自动回滚

方案2：手动修改迁移代码，单独为枚举操作禁用事务 #

如果迁移内还有其他需要事务保障的操作，可以替换自动生成的迁移代码，单独指定枚举加值SQL不参与事务：

protected override void Up(MigrationBuilder migrationBuilder)
{
    // 单独设置枚举加值操作不启用事务
    migrationBuilder.Sql("ALTER TYPE patient_ethnicity_enum ADD VALUE 'hi'", suppressTransaction: true);
}

注意：PostgreSQL 原生不支持删除已存在的枚举值，自动生成的Down方法默认无法执行，若无强制回滚需求可直接清空Down方法的逻辑；若必须支持回滚，需要手动编写枚举类型全量替换的逻辑，流程为：新建临时枚举类型→修改字段类型为临时枚举→删除原枚举→重建原枚举（不含待删除的枚举值）→修改字段类型回原枚举→删除临时枚举

方案3：升级Npgsql EF Core依赖版本 #

Npgsql.EntityFrameworkCore.PostgreSQL 从5.0.7版本开始已经适配了该场景，会自动将枚举加值的操作标记为无需事务，升级到对应版本后重新生成迁移，无需额外修改即可直接执行。

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