Rails 7 + PostgreSQL枚举：为何存储值而非键？

问题场景 #

在基于PostgreSQL的Rails 7应用中，为User模型定义了status枚举，出现存储时的异常问题：

迁移文件代码 #

class CreateUsers < ActiveRecord::Migration[7.0]
  def change
    create_enum :status, ["pending", "active", "archived"]

    create_table :users, force: true do |t|
      t.enum :status, enum_type: "status", default: "pending", null: false
      t.timestamps
    end
  end
end

模型代码（app/models/user.rb） #

class User < ApplicationRecord
  enum status: {
    pending: 'Is Pending',
    active: 'Is active',
    archived: 'Is Archived',
    disabled: 'is Disabled',
    waiting: 'waiting'
  }
end

注：枚举键与显示值分离（如pending映射为Is Pending）

视图代码 #

<%= f.collection_select(:status,  enum_to_collection_select( User.defined_enums['status']), :key, :value, {selected: @user.status }, class: 'form-control') %>

现象 #

视图显示正常，提交请求时参数传递的是枚举键（如"active"）：

10:00:02 web.1  | Started POST "/users" for 127.0.0.1 at 2023-02-07 10:00:02 -0500
10:00:02 web.1  | Processing by UsersController#create as TURBO_STREAM
10:00:02 web.1  |   Parameters: {"authenticity_token"=>"[FILTERED]", "user"=>{"status"=>"active"}, "commit"=>"Save"}
10:00:02 web.1  |   TRANSACTION (0.1ms)  BEGIN
10:00:02 web.1  |   ↳ app/controllers/users_controller.rb:34:in `create'

但保存记录时，Rails却尝试存储枚举对应的显示值（如"Is active"），导致PostgreSQL枚举校验失败：

10:00:02 web.1  |   User Create (0.8ms)  INSERT INTO "users" ("status", "created_at", "updated_at") VALUES ($1, $2, $3) RETURNING "id"  [["status", "Is active"], ["created_at", "2023-02-07 15:00:02.951440"], ["updated_at", "2023-02-07 15:00:02.951440"]]
10:00:02 web.1  |   ↳ app/controllers/users_controller.rb:34:in `create'
10:00:02 web.1  |   TRANSACTION (0.1ms)  ROLLBACK
10:00:02 web.1  |   ↳ app/controllers/users_controller.rb:34:in `create'
10:00:02 web.1  | Completed 500 Internal Server Error in 5ms (ActiveRecord: 1.0ms | Allocations: 4529)
10:00:02 web.1  | 
10:00:02 web.1  | ActiveRecord::StatementInvalid (PG::InvalidTextRepresentation: ERROR:  invalid input value for enum status: "Is active"
10:00:02 web.1  | CONTEXT:  unnamed portal parameter $1 = '...'
10:00:02 web.1  | ):

疑问 #

• 为何PostgreSQL不使用键而非值进行存储？
• 枚举的设计初衷不正是可以修改前端显示值而无需改动数据库吗？
• 为何Rails在保存记录时会将键转换为值？

原因分析 #

Rails的enum宏默认逻辑是：键是Ruby层面的语义化标识，值是要存储到数据库的实际内容。当前写法把显示文本作为枚举值，完全搞反了Rails枚举的设计逻辑：

1. 提交的键会被Rails自动转换成对应的枚举值存储，而你设置的枚举值（如Is active）不在PostgreSQL预定义的枚举列表里，因此触发校验报错。
2. 模型中定义的disabled、waiting键，对应的数据库枚举值根本不存在，后续操作也会触发异常。

枚举的设计初衷确实是分离语义标识与存储值、显示文本，但你错误地将显示文本绑定到了数据库存储值的位置，导致逻辑混乱。

解决方案 #

1. 修正枚举定义逻辑 #

将模型枚举改为键: 数据库存储值的结构，显示文本单独通过方法处理：

class User < ApplicationRecord
  enum status: {
    pending: 'pending',
    active: 'active',
    archived: 'archived'
    # 若需要disabled、waiting，需先通过迁移添加到PostgreSQL枚举
  }

  # 实例方法：获取当前状态的显示文本
  def status_display
    {
      pending: 'Is Pending',
      active: 'Is active',
      archived: 'Is Archived'
    }[status.to_sym]
  end

  # 类方法：供视图生成下拉选项
  def self.status_options
    {
      'Is Pending' => 'pending',
      'Is active' => 'active',
      'Is Archived' => 'archived'
    }
  end
end

2. 修正视图代码 #

使用正确的选项集合生成下拉框：

<%= f.select :status, User.status_options, {selected: @user.status }, class: 'form-control' %>

3. 同步数据库与模型枚举 #

如果确实需要disabled、waiting状态，先通过迁移添加到PostgreSQL枚举：

class AddDisabledWaitingToStatusEnum < ActiveRecord::Migration[7.0]
  def change
    execute <<-SQL
      ALTER TYPE status ADD VALUE 'disabled';
      ALTER TYPE status ADD VALUE 'waiting';
    SQL
  end
end

执行迁移后，再在模型枚举中添加对应键值对。

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