Devise+OmniAuth-Google-OAuth2登录触发ActionController::RoutingError

先给你划个重点：/o/oauth2/auth是谷歌OAuth2的官方授权端点，不是OmniAuth在你的应用里生成的路由。你直接访问这个路径肯定会失败，正确的流程是通过OmniAuth生成的Devise路由，自动跳转到谷歌的这个授权页面。下面一步步帮你排查解决：

1. 修正Routes.rb的控制器配置 #

你提到的路由配置看起来有路径错误，正确的回调控制器路径应该指向users/omniauth_callbacks，而不是users/auth...。修改你的routes.rb：

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

同时要确保你有对应的控制器文件app/controllers/users/omniauth_callbacks_controller.rb，基础示例代码如下：

class Users::OmniauthCallbacksController < Devise::OmniauthCallbacksController
  def google_oauth2
    # 从谷歌返回的信息中查找/创建用户
    @user = User.from_omniauth(request.env['omniauth.auth'])
    
    if @user.persisted?
      sign_in_and_redirect @user, event: :authentication
      set_flash_message(:notice, :success, kind: 'Google') if is_navigational_format?
    else
      # 保存临时数据，跳转到注册页面补充信息
      session['devise.google_data'] = request.env['omniauth.auth'].except(:extra)
      redirect_to new_user_registration_url
    end
  end

  def failure
    redirect_to root_path, alert: '登录失败，请稍后重试'
  end
end

2. 检查Devise初始化配置 #

确认config/initializers/devise.rb里的谷歌OAuth2配置完整且正确，要包含谷歌开发者控制台获取的Client ID和Secret：

config.omniauth :google_oauth2, ENV['GOOGLE_CLIENT_ID'], ENV['GOOGLE_CLIENT_SECRET'],
  scope: 'email,profile', # 申请的权限范围
  prompt: 'select_account', # 强制用户选择账号
  redirect_uri: 'http://localhost:3000/users/auth/google_oauth2/callback' # 本地开发回调地址，生产环境替换为实际域名

注意：这里的redirect_uri必须和你在谷歌开发者控制台里配置的授权重定向URI完全一致，包括HTTP/HTTPS、域名、端口，否则谷歌会拒绝请求。

3. 使用正确的登录触发链接 #

前端的登录按钮要指向OmniAuth生成的Devise路由，而不是直接访问谷歌的端点。在视图里用路由辅助方法生成链接：

<%= link_to "使用Google登录", user_google_oauth2_omniauth_authorize_path, class: "btn btn-google" %>

当用户点击这个链接时，OmniAuth会自动处理跳转，把请求转发到谷歌的https://accounts.google.com/o/oauth2/auth授权页面，而不是让你直接访问本地的/o/oauth2/auth。

4. 常见问题排查 #

• 版本兼容性：确保devise和omniauth-google-oauth2的版本兼容，建议使用最新稳定版，避免因版本不匹配导致路由生成异常。
• 谷歌控制台配置：检查谷歌开发者控制台里的OAuth客户端ID是否启用，是否添加了正确的测试域名/生产域名。
• 服务器日志：查看Rails服务器日志，获取请求失败的具体错误信息——如果是404，大概率是路由配置错误；如果是谷歌返回的错误，一般会提示Client ID无效、回调地址不匹配等具体原因。

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