Rails 4.2.5中Devise+Bootstrap+Recaptcha验证失败错误显示异常

嘿，这个问题我之前帮朋友排查过类似的，核心原因是Recaptcha验证失败后，Devise默认的注册控制器没有保留用户之前填写的表单数据，导致页面重载后所有内容清空，还因为参数丢失触发了“邮箱不能为空”的误报——哪怕你实际填了内容。下面是具体的解决步骤：

1. 自定义Devise注册控制器 #

默认的Devise控制器不会处理Recaptcha验证失败后的参数保留逻辑，所以我们需要生成自己的注册控制器：

rails generate devise:controllers users

然后修改config/routes.rb，指定使用自定义的控制器：

devise_for :users, controllers: { registrations: 'users/registrations' }

2. 重写注册控制器的create动作 #

打开app/controllers/users/registrations_controller.rb，替换成以下代码，重点是在Recaptcha验证失败时保留用户输入的参数：

class Users::RegistrationsController < Devise::RegistrationsController
  def create
    # 先把用户提交的参数赋值给resource对象
    build_resource(sign_up_params)

    # 先验证Recaptcha，再验证用户数据
    if verify_recaptcha(model: resource) && resource.save
      # 这部分是Devise默认的注册成功逻辑，不用改
      if resource.active_for_authentication?
        set_flash_message! :notice, :signed_up
        sign_up(resource_name, resource)
        respond_with resource, location: after_sign_up_path_for(resource)
      else
        set_flash_message! :notice, :"signed_up_but_#{resource.inactive_message}"
        expire_data_after_sign_in!
        respond_with resource, location: after_inactive_sign_up_path_for(resource)
      end
    else
      # 关键：清理密码参数（避免明文回显），但保留其他输入
      clean_up_passwords(resource)
      # 给resource添加Recaptcha验证失败的错误提示
      resource.errors.add(:base, "Recaptcha验证失败，请重新尝试")
      # 渲染注册页面，此时resource里保留了用户之前的输入，视图会自动回显
      respond_with resource
    end
  end

  private

  # 确保这里包含所有你需要的注册参数（比如email、password、username等）
  def sign_up_params
    params.require(:user).permit(:email, :password, :password_confirmation)
  end
end

3. 确保视图正确回显数据和错误 #

检查你的注册视图（通常是app/views/devise/registrations/new.html.erb，如果用了devise-bootstrap-views则路径类似）：

• 表单字段要使用Devise的表单 helper，比如<%= f.email_field :email %>，这样会自动从resource对象读取之前的输入值
• 确保Recaptcha标签关联到resource：<%= recaptcha_tags model: @user %>
• 保留Devise的错误提示组件，比如<%= devise_error_messages! %>，这样会显示Recaptcha的错误提示

4. 测试验证逻辑 #

重启服务器后，填写注册信息但不完成Recaptcha提交，此时页面应该会：

• 保留你填写的所有表单内容
• 显示“Recaptcha验证失败，请重新尝试”的错误提示
• 不会再出现“email can't be blank”的误报

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