如何在基于Devise和Active Admin的Rails应用中设置自定义用户ID

没问题，这个需求其实挺常见的，咱们一步步来实现，兼顾Devise注册流程和Active Admin的管理需求：

1. 给User模型添加自定义ID字段 #

首先，建议保留默认的id作为数据库内部主键（避免破坏Devise和Active Admin的默认逻辑），新增一个字段存储用户自定义ID。

生成迁移文件：

rails generate migration AddCustomIdToUsers custom_id:string:uniq

运行迁移生效：

rails db:migrate

这会给users表添加custom_id字符串字段，并自动创建唯一索引，确保不会出现重复的自定义ID。

2. 给User模型添加验证规则 #

在app/models/user.rb中添加验证逻辑，确保自定义ID符合预期格式：

class User < ApplicationRecord
  devise :database_authenticatable, :registerable,
         :recoverable, :rememberable, :validatable

  # 自定义ID验证规则
  validates :custom_id, 
            presence: true,
            uniqueness: { case_sensitive: false }, # 不区分大小写，比如Greg51和greg51视为重复
            format: { with: /\A[a-zA-Z0-9]+\z/, message: "只能包含字母和数字" },
            length: { minimum: 3, maximum: 20 } # 可选：限制ID长度范围
end

3. 修改Devise注册表单，允许用户输入自定义ID #

如果还没生成过Devise视图文件，先执行命令生成：

rails generate devise:views

然后编辑app/views/devise/registrations/new.html.erb，添加自定义ID的输入框：

<div class="field">
  <%= f.label :custom_id %>
  <%= f.text_field :custom_id, autofocus: true %>
  <%= f.error_message_on :custom_id %>
</div>

还要让Devise允许接收custom_id参数，在app/controllers/application_controller.rb中添加：

class ApplicationController < ActionController::Base
  before_action :configure_permitted_parameters, if: :devise_controller?

  protected

  def configure_permitted_parameters
    devise_parameter_sanitizer.permit(:sign_up, keys: [:custom_id])
  end
end

4. 适配Active Admin的用户管理 #

编辑app/admin/user.rb，让后台支持自定义ID的创建和编辑：

ActiveAdmin.register User do
  permit_params :email, :password, :password_confirmation, :custom_id

  form do |f|
    f.inputs do
      f.input :custom_id # 添加自定义ID输入框
      f.input :email
      f.input :password
      f.input :password_confirmation
    end
    f.actions
  end

  # 可选：在列表视图显示自定义ID，方便后台查看
  index do
    selectable_column
    column :custom_id
    column :email
    column :created_at
    actions
  end
end

5. 让应用URL使用自定义ID（可选） #

如果希望用户个人页面的URL从/users/1变成/users/greg51，修改User模型的to_param方法：

class User < ApplicationRecord
  # ... 其他代码 ...

  def to_param
    custom_id # 用自定义ID代替默认数字ID生成URL
  end
end

同时在config/routes.rb中更新用户资源路由：

resources :users, param: :custom_id

这样user_path(@user)会自动生成/users/greg51格式的URL。

6. 支持用自定义ID登录（可选） #

如果想让用户可以用自定义ID代替邮箱登录，修改config/initializers/devise.rb：

config.authentication_keys = [:custom_id, :email]

这样用户登录时输入自定义ID或邮箱，配合密码就能完成登录。

测试验证 #

完成以上步骤后，记得测试几个关键场景：

• 注册时输入重复/不符合格式的自定义ID，是否会弹出正确的错误提示
• Active Admin创建用户时，重复ID是否会触发验证报错
• 登录时用自定义ID能否成功登录
• 用户页面的URL是否正确显示自定义ID

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