Rails Devise集成Google reCAPTCHA V3注册返回405错误如何解决

第一步：修复recaptcha初始化配置错误 #

你当前config/initializers/recaptcha.rb中的proxy参数配置完全错误：该参数仅当你的服务器需要通过自建代理访问谷歌服务时才需要填写，值为你的代理服务地址，不能填谷歌的验证接口地址，错误的proxy配置会导致请求路径/方法不匹配，直接触发405错误。

修改后配置如下：

Recaptcha.configure do |config|
  config.site_key = Rails.application.credentials.dig(:google, :RECAPTCHA_PUBLIC_KEY)
  config.secret_key = Rails.application.credentials.dig(:google, :RECAPTCHA_PRIVATE_KEY)
  # 仅当你有自建代理时才取消注释下面这行，值为你的代理地址
  # config.proxy = "http://127.0.0.1:1080"
  # 国内服务器无法访问谷歌默认接口时，可添加下面这行用国内可访问的验证地址
  # config.verify_url = "https://recaptcha.net/recaptcha/api/siteverify"
end

修改完成后重启Rails服务即可生效。

第二步：确认依赖版本适配 #

确保你Gemfile中引入的recaptcha gem版本不低于5.0，只有5.0以上版本原生支持reCAPTCHA V3：

# 建议使用最新稳定版
gem 'recaptcha', '~> 5.15'

修改后执行bundle install，重启服务生效。

可选排查方案 #

如果修改后仍有问题，可以在check_captcha方法中加入日志，查看谷歌返回的具体错误信息：

def check_captcha
  verify_result = verify_recaptcha(action: 'signup')
  # 日志会输出验证结果和谷歌返回的详细信息
  Rails.logger.info "reCAPTCHA验证结果：#{verify_result}，返回详情：#{recaptcha_reply.inspect}"
  return if verify_result

  # 原有逻辑保持不变
  self.resource = resource_class.new sign_up_params
  resource.validate
  set_minimum_password_length

  respond_with_navigational(resource) do
    flash.discard(:recaptcha_error)
    render :new
  end
end

查看Rails运行日志即可拿到具体错误原因，针对性处理。

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