Rails迁移中如何为表字段定义原生enum类型并解决schema导出错误

该报错是Rails默认的Ruby格式schema导出器（schema.rb）原生不支持PostgreSQL的自定义枚举类型，无法识别你创建的statuses类型，因此导出schema时触发错误。

• 方案1：切换为SQL格式的schema导出
  这是最直接适配数据库自定义类型的方案，步骤如下：

  1. 在config/application.rb中添加配置：

  config.active_record.schema_format = :sql
  

  2. 后续运行迁移后，Rails会生成db/structure.sql替代原有的schema.rb，原生支持所有PostgreSQL特有的语法，不会触发类型识别错误。

• 方案2：使用Rails模型层枚举（无需数据库自定义类型）
  不需要修改schema格式，兼容性更强，是更推荐的Rails风格实现：

  1. 修改迁移文件，直接用字符串类型存储状态，删除自定义枚举类型的SQL逻辑：

  def up
    add_column :users, :status, :string, default: 'pending'
  end
  
  def down
    remove_column :users, :status
  end
  

  2. 在app/models/user.rb中添加枚举定义：

  enum status: {
    pending: 'pending',
    'on-going': 'on-going'
  }
  

  配置后你依然可以调用user.pending?、user.on_going!等枚举原生方法，效果和数据库层枚举一致。

• 方案3：为自定义类型注册识别规则
  如果你既要保留数据库层枚举，又不想切换为SQL格式schema，可以在初始化器中为导出器注册自定义类型的识别规则：

  1. 新建config/initializers/postgresql_enum_types.rb，添加如下内容：

  ActiveRecord::ConnectionAdapters::PostgreSQL::OID.register_type('statuses') do
    ActiveRecord::Type::String.new
  end
  

  配置后导出器会将statuses类型识别为字符串，即可正常导出schema.rb。

你当前编写的down回滚逻辑顺序错误，必须先删除依赖枚举类型的列，再删除枚举类型，否则回滚时会触发类型被依赖的报错，修改后如下：

def down
  remove_column :users, :status
  execute <<-SQL
    DROP TYPE statuses;
  SQL
end

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