PostgreSQL添加Enum值后，如何编写对应的Down迁移？

嘿，这个问题确实是PostgreSQL枚举类型的一个小痛点——毕竟它天生不支持直接删除枚举值，这就给我们的迁移回滚带来了不小的麻烦。你提到的那种“Up加IF NOT EXISTS、Down啥也不干”的方案确实不够优雅，迁移的对称性被破坏了，回滚的时候总觉得心里不踏实对吧？下面给你分享几个业界常用的解决思路：

这是最贴近“对称迁移”的方案，核心思路是在Down迁移里通过创建临时枚举、替换类型的方式间接删除新增值。具体步骤如下：

• Up迁移：直接添加新枚举值，简单直接

  ALTER TYPE your_enum ADD VALUE 'new_enum_value';
  

• Down迁移：通过一系列操作“变相”移除新增值

  BEGIN;
  -- 1. 创建临时枚举，仅包含原有的枚举值（排除新增的那个）
  CREATE TYPE your_enum_temp AS ENUM ('original_val1', 'original_val2');
  
  -- 2. 将使用原枚举的列转为文本类型，避免类型不兼容报错
  ALTER TABLE your_target_table ALTER COLUMN enum_column TYPE TEXT USING enum_column::TEXT;
  
  -- 3. 删除原枚举类型
  DROP TYPE your_enum;
  
  -- 4. 把临时枚举重命名为原枚举的名字
  ALTER TYPE your_enum_temp RENAME TO your_enum;
  
  -- 5. 将列改回枚举类型
  ALTER TABLE your_target_table ALTER COLUMN enum_column TYPE your_enum USING enum_column::your_enum;
  COMMIT;
  

⚠️ 注意：执行Down迁移前，必须确保所有使用该枚举的列中没有新增的那个值（比如提前把这些记录更新为其他有效值，或者删除），否则会触发数据转换错误。

如果你的项目还处于初期，或者可以接受调整架构，推荐直接放弃PostgreSQL原生ENUM，改用一张独立的枚举表+外键的方式。这种方案从根源上解决了枚举值无法删除的问题：

• 先创建枚举表：

  CREATE TABLE order_status (
      status_code TEXT PRIMARY KEY,
      status_name TEXT NOT NULL
  );
  -- 插入初始枚举值
  INSERT INTO order_status VALUES ('paid', '已支付'), ('unpaid', '未支付');
  

• 业务表通过外键关联枚举表：

  CREATE TABLE orders (
      id SERIAL PRIMARY KEY,
      status TEXT REFERENCES order_status(status_code) NOT NULL
  );
  

• Up迁移：往枚举表里插入新值即可

  INSERT INTO order_status VALUES ('refunded', '已退款');
  

• Down迁移：直接删除新增的枚举值（同样要先处理关联的业务数据）

  DELETE FROM order_status WHERE status_code = 'refunded';
  

这种方案的优势是迁移完全对称，后期扩展、修改枚举值都更灵活，唯一的小代价是查询时可能需要多一次关联，但大部分场景下性能影响可以忽略。

如果你的项目回滚旧版本的场景极少，或者新增的枚举值确定不会被移除，也可以接受这个你不太喜欢的方案，但要做明确的标记：

-- Up迁移：避免重复添加
ALTER TYPE your_enum ADD VALUE IF NOT EXISTS 'new_value';

-- Down迁移：明确标注不可逆性
-- 注意：PostgreSQL不支持删除枚举值，此迁移不可逆
-- 若需回滚，请先手动清理使用该值的业务数据，再参考方案一替换枚举类型

关键是要让团队所有成员都清楚这个迁移的特性，避免后续踩坑。

总的来说，如果能调整架构，优先选方案二；已经用了原生ENUM的话，方案一是最接近对称迁移的选择；方案三作为最后备选，适合回滚需求极低的场景。

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