Sequelize Migration添加ENUM类型数组列报错如何解决？

报错根因 #

PostgreSQL 中枚举类型的数组类型不会随基础枚举类型自动生成，且 Sequelize ARRAY(ENUM()) 的语法默认会自动拼接枚举类型名查找对应的数组类型，即使你手动创建了基础枚举类型，也会因为Sequelize内部类型匹配逻辑异常报错。

方案1：直接使用原生SQL执行（最稳定，无兼容问题） #

跳过Sequelize的类型封装，直接用原生SQL完成枚举创建和列添加操作，代码示例如下：

// up 函数逻辑
await queryInterface.sequelize.query(`
  CREATE TYPE enum_Locations_tags AS ENUM ('Competitor', 'Multi Location', 'Duplicate');
  ALTER TABLE "Locations" ADD COLUMN tags enum_Locations_tags[] DEFAULT '{}';
`);

// 对应down函数回滚逻辑
await queryInterface.sequelize.query(`
  ALTER TABLE "Locations" DROP COLUMN tags;
  DROP TYPE enum_Locations_tags;
`);

方案2：为Sequelize ENUM指定已创建的枚举名称 #

手动创建枚举后，在ENUM配置中明确指定name参数告知Sequelize现有枚举的名称，让它可以正确匹配到类型：

await queryInterface.sequelize.query("CREATE TYPE enum_Locations_tags AS ENUM ('Competitor', 'Multi Location', 'Duplicate');");
await queryInterface.addColumn(
  'Locations',
  'tags',
  {
    type: Sequelize.ARRAY(Sequelize.ENUM({
      name: 'enum_Locations_tags', // 新增这一行，指定已创建的枚举名
      values: ['Competitor', 'Multi Location', 'Duplicate']
    })),
    defaultValue: [] // 可选，默认空数组
  }
);

注意事项 #

• 两种方案的回滚逻辑都需要先删除关联列，再删除自定义枚举类型，否则会因为枚举被列依赖无法删除报错。
• 如果你使用的是多schema的数据库，需要在枚举名称前指定对应的schema名称，比如public.enum_Locations_tags。

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