Prisma为已有ENUM类型新增值执行迁移报错的解决方法

这个错误是PostgreSQL数据库本身的执行限制，和Prisma的迁移默认逻辑有关：

• PostgreSQL 从10版本开始支持通过ALTER TYPE 枚举名 ADD VALUE '新值'给已有枚举类型追加可选值，但该语句禁止在多语句事务块、存储函数/过程中执行。
• Prisma Migrate默认会把单个迁移文件内的所有SQL语句包裹在同一个事务块中提交，刚好触发了上述限制，所以迁移执行直接失败。
  仅新增枚举值、不修改/删除原有值的操作逻辑本身没有问题，只是执行方式不符合PostgreSQL的语法规则。

优先选择第一种方案，完全适配Prisma的迁移工作流，不会打乱迁移版本记录，生产环境可用：

方案1：配置单迁移跳过事务 #

• 先修改schema.prisma文件，在目标枚举类型中直接添加需要的新枚举值。
• 执行以下命令，只生成迁移文件、不自动运行迁移：

npx prisma migrate dev --create-only --name 自定义迁移名，例如add_xxx_to_xxx_enum

• 打开刚生成的迁移文件夹（路径在prisma/migrations/目录下，文件夹名是生成的时间戳+你自定义的迁移名）里的migration.sql文件，在文件最顶部加一行配置，告诉Prisma执行这个迁移时不要开启全局事务：

-- prisma.migration.skipTransaction = true

• 检查文件内的SQL，确认只有追加枚举值的ALTER TYPE语句即可（如果这个迁移里还有其他表结构修改，建议拆成单独的迁移，避免非事务执行引发异常），之后正常执行npx prisma migrate dev就能顺利完成迁移，不会触发报错。

方案2：手动预修改+空迁移（适合本地/测试环境快速处理） #

• 先通过数据库客户端直连PostgreSQL实例，手动执行枚举追加语句：

ALTER TYPE "你的枚举类型名" ADD VALUE '你要新增的枚举值';

• 修改schema.prisma里的枚举定义，加上和数据库侧一致的新值。
• 执行npx prisma migrate dev --create-only --name add_xxx_enum_value生成迁移文件，打开migration.sql把Prisma自动生成的ALTER TYPE语句删掉（数据库侧已经完成修改，重复执行会报错），再执行npx prisma migrate dev，Prisma会把这个空迁移标记为已应用，后续多环境部署时迁移状态也能正常对齐。

• 仅新增枚举值属于PostgreSQL的元数据修改操作，执行速度极快，不会长时间锁表，也不需要改动现有业务数据。不要用「删除旧枚举→重建新枚举→修改字段类型」的重操作，反而容易引发数据丢失或类型不匹配错误。
• 如果你的PostgreSQL版本低于12，必须使用上述跳过事务的方式执行，低版本PG完全不允许在事务块内执行任何ALTER TYPE ADD VALUE操作。

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