升级Rails 7.1后出现「Unknown enum attribute」错误如何修复？

针对你遇到的Unknown enum attribute 'auth_type' for Company错误，本质是Rails 7.1新增了enum字段的强制校验机制——默认要求enum对应的数据库列必须存在才能加载模型。迁移执行时模型提前加载，而对应列还未创建（或迁移顺序存在问题）就会触发这个错误，以下是几种修复思路：

1. 检查迁移文件是否提前引用了模型 #

如果你的迁移文件中在创建auth_type列之前就实例化了Company模型（比如调用Company.create、Company.find等方法），会导致模型提前加载，此时数据库还没有auth_type列，从而触发错误。

修复方式：迁移中避免直接使用ActiveRecord模型，改用原生SQL操作，或者延迟模型加载：

# 错误示例：迁移中直接调用模型
def up
  add_column :companies, :auth_type, :string
  Company.update_all(auth_type: 'password') # 这里会提前加载模型
end

# 正确做法：用SQL代替
def up
  add_column :companies, :auth_type, :string
  execute "UPDATE companies SET auth_type = 'password'"
end

2. 给Enum定义加列存在判断 #

在模型中只当数据库存在auth_type列时才定义enum，避免迁移过程中模型加载时触发校验：

class Company < ApplicationRecord
  # 仅当列存在时定义enum
  if column_names.include?('auth_type')
    enum auth_type: {
      password: 'password',
      magic_link: 'magic_link',
      google: 'google',
      microsoft: 'microsoft',
      saml: 'saml',
      workos: 'workos',
      developer: 'developer'
    }, _prefix: :auth_by
  end
end

这种方式不会影响正常运行时的enum功能，只是在迁移阶段跳过定义。

3. 临时关闭Enum列强制校验 #

Rails 7.1新增了config.active_record.enum_require_column配置，默认值为true，强制校验enum对应列存在。可以在迁移期间临时关闭该配置，完成后再恢复：

# config/application.rb
# 迁移完成后记得改回true
config.active_record.enum_require_column = false

注意：这个是全局配置，迁移完成后建议改回true，避免后续代码中定义了不存在列的enum而无法及时发现问题。

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