Rails 7搭配MongoDB 8下如何使用枚举类型？

关于切换到SQL数据库的可行性 #

• 完全可行，但仅当你的项目不依赖MongoDB的核心特性（如动态文档结构、大规模水平扩展、嵌套文档等）时推荐。如果项目一开始就基于MongoDB设计，切换到SQL会带来数据迁移、模型重构等额外成本，没必要为了枚举功能放弃MongoDB。

无需切换数据库的替代方案 #

1. 手动实现枚举逻辑（最稳定靠谱） #

不需要依赖任何第三方gem，直接在Model中定义常量、验证和便捷方法，完全兼容MongoDB 8：

class YourModel
  include Mongoid::Document

  # 定义合法的枚举值
  STATUS_VALUES = %w[open closed pending].freeze
  field :status, type: String

  # 验证状态值的合法性
  validates :status, inclusion: { in: STATUS_VALUES }, allow_nil: false

  # 生成类似ActiveRecord枚举的便捷方法（可选）
  STATUS_VALUES.each do |status|
    # 实例方法：model.open?
    define_method "#{status}?" do
      self.status == status
    end

    # 类方法：YourModel.open
    define_singleton_method "#{status}" do
      where(status: status)
    end
  end
end

使用方式和ActiveRecord枚举一致，且数据直接存储为字符串，不会出现重启控制台后值丢失的问题。

2. 修复Phantom Custom Field Types的序列化问题 #

你遇到的status存后变为nil的问题，本质是自定义字段类型没有正确实现序列化/反序列化逻辑。MongoDB的自定义字段需要处理Ruby对象与数据库存储格式的转换：

# 定义自定义状态字段类型
class StatusField
  include Mongoid::Fields::Serializable

  # 将Ruby值转换为数据库存储格式
  def serialize(value)
    return nil unless value.present?
    # 确保存储为合法的小写字符串
    value.to_s.downcase.tap do |val|
      raise ArgumentError, "Invalid status: #{val}" unless %w[open closed pending].include?(val)
    end
  end

  # 将数据库存储值转换为Ruby对象
  def deserialize(value)
    value.to_s if value.present?
  end
end

# 在Model中使用自定义字段
class YourModel
  include Mongoid::Document
  field :status, type: StatusField
end

• 确保serialize方法返回的是MongoDB能识别的类型（如字符串）
• 添加参数校验，避免非法值被静默存储
• 测试时使用save!（带感叹号），这样如果有错误会抛出异常，而非静默失败

3. 使用维护活跃的替代gem #

如果不想手动实现，可以尝试mongoid_enum_improved（需提前确认其兼容MongoDB 8），但相比手动实现，第三方gem仍有兼容风险，建议优先考虑手动方案。

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