Rails迁移报错：ENUM类型已存在（附环境版本信息）

你遇到的这个问题核心原因是PostgreSQL的枚举类型是数据库级别的全局对象，并非绑定到单个数据表。第一个模型的迁移已经创建了名为status的枚举类型，第二个迁移再执行CREATE TYPE status AS ENUM...自然会触发重复创建的报错。

下面给你几种实用的解决办法：

方法1：直接复用已存在的枚举类型 #

如果两个模型的status枚举值完全一致，修改第二个模型的迁移文件，跳过重复创建枚举的步骤，直接给字段指定已有的status类型即可：

class AddStatusToExperiences < ActiveRecord::Migration[5.1]
  def up
    add_column :experiences, :status, :status, default: 'created', null: false
  end

  def down
    remove_column :experiences, :status
  end
end

方法2：给枚举类型加前缀做区分 #

如果两个模型的status枚举值可能存在差异，或者你希望它们是独立的类型，可以给枚举类型加上表名前缀，避免全局冲突。

先修改第一个模型的迁移文件（如果还没部署到生产环境）：

class AddStatusToPosts < ActiveRecord::Migration[5.1]
  def up
    create_enum :post_status, ['created', 'published', 'archived']
    add_column :posts, :status, :post_status, default: 'created', null: false
  end

  def down
    remove_column :posts, :status
    drop_enum :post_status
  end
end

再调整第二个模型的迁移文件：

class AddStatusToExperiences < ActiveRecord::Migration[5.1]
  def up
    create_enum :experience_status, ['created', 'published', 'archived']
    add_column :experiences, :status, :experience_status, default: 'created', null: false
  end

  def down
    remove_column :experiences, :status
    drop_enum :experience_status
  end
end

同时，模型里也要对应修改枚举定义，避免方法名冲突：

# app/models/experience.rb
class Experience < ApplicationRecord
  enum status: { created: 'created', published: 'published', archived: 'archived' }, _prefix: true
end

_prefix: true会生成experience_created?这类带前缀的方法，防止和其他模型的枚举方法重名。

方法3：检查枚举存在性后再操作 #

如果无法修改已执行过的迁移，或者需要兼容已有数据库，可以在第二个迁移里先判断status枚举是否存在，不存在再创建：

class AddStatusToExperiences < ActiveRecord::Migration[5.1]
  def up
    # 检查枚举类型是否已存在
    unless ActiveRecord::Base.connection.execute("SELECT 1 FROM pg_type WHERE typname = 'status'").any?
      create_enum :status, ['created', 'published', 'archived']
    end
    add_column :experiences, :status, :status, default: 'created', null: false
  end

  def down
    remove_column :experiences, :status
    # 只有当没有表使用该枚举时才删除，避免报错
    if ActiveRecord::Base.connection.execute("SELECT 1 FROM pg_attribute WHERE atttypid = (SELECT oid FROM pg_type WHERE typname = 'status')").none?
      drop_enum :status
    end
  end
end

注意：如果两个模型的status枚举值不完全相同，复用同一个枚举类型会引发问题——因为枚举值是全局的，新增或修改值会影响所有使用该类型的表，这种情况更适合用方法2做区分。

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