Rails 5自定义OmniAuth策略未生成期望路由的问题排查

你遇到的核心问题是：你同时用了两种OmniAuth集成方式——单独的OmniAuth::Builder配置，以及Devise自带的OmniAuth集成。Devise的命名路由（比如user_platform_omniauth_authorize_path）是基于Devise自身的OmniAuth配置生成的，单独注册的OmniAuth策略不会被Devise识别，自然生成不了对应的路由。

下面是具体的修复步骤：

1. 迁移自定义策略到Devise的OmniAuth配置 #

首先，我们要把自定义的Platform策略注册到Devise的配置里，而不是单独用OmniAuth::Builder：

• 打开config/initializers/devise.rb，找到你已经配置好的谷歌、推特等OmniAuth provider的位置，添加你的Platform策略：

# 在devise.rb的配置块内添加
config.omniauth :platform, "Client Id", "Client Secret", 
  client_options: { 
    site: "https://my.auth.provider", 
    authorize_url: "/connect/authorize",
    user_info_url: "/connect/userinfo" 
  }

• 然后删除config/initializers/omniauth.rb里的这段代码（保留上面的autoload部分，用来加载自定义策略）：

# 删掉这段，Devise会自动处理中间件
Rails.application.config.middleware.use OmniAuth::Builder do
  provider :platform, "Client Id", "Client Secret", client_options: { site: "https://my.auth.provider", user_info_url: "/connect/userinfo" }
end

2. 确保lib目录被Rails加载 #

你的自定义策略放在lib/strategies下，Rails默认不会自动扫描这个目录。需要在config/application.rb里添加加载配置：

# 让Rails加载lib下的所有子目录
config.autoload_paths += Dir["#{config.root}/lib/**/"]
config.eager_load_paths += Dir["#{config.root}/lib/**/"]

（注：开发环境用autoload_paths自动加载，生产环境用eager_load_paths预加载，上面的配置兼顾两种环境）

3. 更新Devise模型的Omniauthable配置 #

打开你的用户模型（比如app/models/user.rb），确保omniauth_providers数组里包含:platform：

devise :database_authenticatable, :registerable,
       :recoverable, :rememberable, :validatable,
       :omniauthable, omniauth_providers: [:google, :twitter, :facebook, :platform]

4. 重启服务器 #

因为修改了初始化文件和加载路径，必须重启Rails服务器才能让配置生效。

验证修复 #

重启后，运行rails routes | grep platform，你应该能看到类似这样的路由输出：

user_platform_omniauth_authorize GET|POST /auth/platform(.:format)       omniauth_callbacks#passthru
user_platform_omniauth_callback  GET|POST /auth/platform/callback(.:format) omniauth_callbacks#platform

另外，你可以把lib/strategies/platform.rb里的默认client_options去掉，统一使用Devise配置里的参数，避免重复配置。

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