使用Devise gem跳过邮箱验证时出现唯一性错误的问题

你遇到的问题其实是应用层验证和数据库约束的区别导致的：

你在User模型里通过unless: :skip_email_validation跳过了email的存在性和唯一性验证，但这只是跳过了ActiveRecord在应用层面的检查。而你的数据库中，email字段仍然存在一个唯一索引（就是错误提示里的index_users_on_email），MySQL会把空字符串('')视为相同的值，所以当你插入第二个空邮箱的用户时，数据库层面的唯一约束就会触发报错，和应用层的验证无关。

根据你的业务需求，你可以选择以下两种方案：

方案一：修改数据库索引，允许多个空邮箱 #

如果你确实需要让后台创建的用户可以没有邮箱，那么需要调整数据库的唯一索引，只在邮箱非空时强制唯一性：

1. 生成迁移文件：

rails generate migration AdjustUsersEmailUniqueIndex

2. 编辑生成的迁移文件：

class AdjustUsersEmailUniqueIndex < ActiveRecord::Migration[6.1]
  def change
    # 先移除原有的全局唯一索引
    remove_index :users, :email
    # 添加部分唯一索引，仅当email不为空时生效（MySQL 8.0+支持）
    add_index :users, :email, unique: true, where: "email IS NOT NULL"
  end
end

3. 运行迁移：

rails db:migrate

这样设置后，多个空邮箱的用户可以正常存入数据库，而有邮箱的用户仍然会被强制要求邮箱唯一。

方案二：给后台用户自动生成唯一虚拟邮箱 #

如果你想保留数据库原有的唯一索引（比如前台注册用户仍然需要邮箱唯一），可以给后台创建的无邮箱用户自动生成一个唯一的虚拟邮箱：

修改Admin::UsersController的create方法：

def create
  @user = User.new(user_params)
  @user.skip_email_validation = true
  # 如果没有提供邮箱，生成一个唯一的虚拟邮箱
  unless @user.email.present?
    @user.email = "admin_user_#{SecureRandom.uuid}@your-app-domain.com"
  end
  if @user.save
    redirect_to admin_user_path(@user), success: 'User created.'
  else
    render :new
  end
end

SecureRandom.uuid会生成一个全局唯一的字符串，确保每个虚拟邮箱都不会重复，完美避开数据库的唯一约束，而且不需要修改数据库结构。

以后遇到类似的"跳过验证但数据库仍报错"的问题，优先检查数据库层面的约束（比如唯一索引、非空约束），这些约束是应用层验证管不到的，必须直接修改数据库结构或者避开约束。

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