Npgsql.EntityFrameworkCore.PostgreSQL 中枚举类型迁移的安全性问题分析

问题背景

在使用 Npgsql.EntityFrameworkCore.PostgreSQL 进行数据库迁移时，开发人员可能会遇到一个特定场景下的错误："unsafe use of new value 'x' of enum type y"。这种情况通常发生在以下场景中：

1. 第一个迁移添加了新的枚举值
2. 第二个迁移尝试使用这个新添加的枚举值
3. 当这两个迁移在同一事务中执行时就会报错

技术原理

这个问题的本质与 PostgreSQL 的枚举类型特性以及 EF Core 的事务处理机制有关。PostgreSQL 不允许在同一个事务中既添加新的枚举值又使用这个新值。在 EF Core 9 之前，每个迁移默认是独立的事务，因此这个问题只会在同一个迁移中同时添加和使用枚举值时出现。

然而，EF Core 9 引入了一个重要变更：默认情况下，所有迁移现在都在同一个事务中执行。这一变更虽然提高了数据一致性，但也导致了上述问题的出现范围扩大——现在即使是在不同的迁移中，只要它们在同一批执行，就会触发这个限制。

解决方案

针对这个问题，目前有以下几种解决方案：

1. 分步执行迁移：先执行到添加枚举值的迁移，然后再执行后续迁移。这种方法简单直接，但需要手动干预迁移过程。

2. 禁用事务：通过在迁移中显式禁用事务来规避这个问题。可以使用 migrationBuilder.Sql("COMMIT;") 在关键点提交事务，或者完全禁用迁移的事务。

3. 调整迁移顺序：如果可能，将使用新枚举值的操作放在单独的后续迁移中，确保它们不会与添加枚举值的操作在同一批执行。

最佳实践建议

1. 对于枚举类型的变更，建议采用小步快跑的方式，每次迁移只做最小变更。

2. 在开发环境中，可以考虑配置不同的迁移策略，比如禁用事务或分步执行。

3. 在编写迁移脚本时，对于枚举类型的变更要特别小心，确保添加和使用操作不会出现在同一事务中。

4. 对于集成测试等场景，可能需要调整迁移策略或编写自定义的迁移逻辑来处理这种特殊情况。

总结

这个问题展示了数据库迁移中类型系统变更的复杂性，特别是在强类型系统如 PostgreSQL 的枚举类型中。理解底层数据库的限制和 ORM 框架的行为变化对于设计稳健的迁移策略至关重要。随着 EF Core 9 的事务行为变更，开发人员需要更加注意这种跨迁移的依赖关系，特别是在处理类型系统变更时。