已做客户端校验仍出现spree_users邮箱重复插入错误？求修复方案

收到的错误信息 #

ActiveRecord::RecordNotUnique
TinyTds::Error: Cannot insert duplicate key row in object 'dbo.spree_users' with unique index 'email_idx_unique'. The duplicate key value is (x.kl@xl.com). (ActiveRecord::RecordNotUnique)
TinyTds::Error
Cannot insert duplicate key row in object 'dbo.spree_users' with unique index 'email_idx_unique'. The duplicate key value is (x.kl@xl.com).

相关业务代码 #

def create_full_registration
  @user = Spree::User.new(user_params)
  @user.user_registrations.build(site: site, status: "pending")
  if @user.save
    @form_submission = FormSubmission.new(
      form_type: "registration",
      form_data: form_data_params,
      status: "pending",
      user: @user
    )
    unless @form_submission.save
      render_errors(@form_submission.errors)
    end
  else
    render_errors(@user.errors)
  end
end

数据库表结构（迁移代码） #

create_table "spree_users", force: :cascade do |t|
  t.string "encrypted_password", limit: 128
  t.string "password_salt", limit: 128
  t.string "email"
  t.string "remember_token"
  ...
  t.index ["deleted_at"], name: "index_spree_users_on_deleted_at"
  t.index ["email"], name: "email_idx_unique", unique: true
end

问题 #

已配置客户端校验，用户本应在UI看到邮箱已存在提示，但仍出现该错误。请问原因是什么？除了异常处理外还有哪些潜在修复方案？

原因分析 #

• 并发请求冲突：同一用户快速多次点击提交按钮，客户端校验仅在首次请求前生效，后续请求同时抵达服务器，均绕过服务端前置检查（若未配置），同时插入数据库触发唯一索引冲突。
• 客户端校验被绕过：用户可通过浏览器控制台禁用前端校验逻辑，或直接调用API接口发起请求，完全跳过UI层面的校验。
• 服务端模型验证缺失：当前代码仅依赖数据库唯一索引拦截重复数据，但未在Spree::User模型中添加邮箱唯一性验证，导致无法在ORM层提前拦截重复请求。
• 软删除数据冲突：数据库中存在被软删除（deleted_at不为空）的同邮箱用户，而唯一索引未关联deleted_at字段，新注册时触发索引冲突。

非异常处理类修复方案 #

• 添加模型层面唯一性验证：在Spree::User模型中显式添加邮箱唯一性校验，提前在ORM层拦截重复数据：

  # app/models/spree/user.rb
  validates :email, presence: true, uniqueness: { case_sensitive: false }
  

• 优化唯一索引适配软删除：若存在软删除场景，调整索引关联deleted_at字段，避免已删除用户的邮箱无法复用：

  # 生成新的迁移文件
  def change
    remove_index :spree_users, name: :email_idx_unique
    add_index :spree_users, [:email, :deleted_at], unique: true, where: "deleted_at IS NULL"
  end
  

• 前端防重复提交：点击提交按钮后立即禁用按钮，直到请求完成（成功/失败），避免用户重复触发请求：

  // 示例：前端按钮禁用逻辑
  const submitBtn = document.getElementById('register-btn');
  submitBtn.addEventListener('click', async () => {
    submitBtn.disabled = true;
    try {
      // 发起注册请求
      await registerRequest();
    } catch (e) {
      // 处理错误
    } finally {
      submitBtn.disabled = false;
    }
  });
  

• 服务端并发场景锁机制：在检查邮箱是否存在时使用悲观锁，避免并发请求同时通过检查：

  def create_full_registration
    # 先加锁检查邮箱是否存在
    if Spree::User.where(email: user_params[:email]).lock(true).exists?
      render_errors({ email: ["该邮箱已注册"] })
      return
    end
  
    @user = Spree::User.new(user_params)
    @user.user_registrations.build(site: site, status: "pending")
    # ... 后续逻辑保持不变
  end
  

• 服务端幂等性控制：要求前端请求携带唯一标识（如UUID），服务端缓存该标识，短时间内同一标识的请求仅处理一次：

  def create_full_registration
    request_id = params[:request_id]
    if Rails.cache.exist?("registration:#{request_id}")
      render_errors({ base: ["请求已处理，请稍后重试"] })
      return
    end
  
    Rails.cache.write("registration:#{request_id}", true, expires_in: 5.minutes)
    # ... 后续逻辑保持不变
  end
  

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