Rails 7中独立集成OmniAuth与Devise时路由未识别问题

Devise的干扰可能性 #

如果Devise未将Basecamp配置为登录Provider，通常不会直接干扰OmniAuth的独立路由。但需注意两种潜在冲突场景：

• 若你曾在Devise.setup中配置过omniauth_providers，Devise会自动生成OmniAuth中间件实例，此时手动添加的OmniAuth::Builder可能出现重复加载，导致策略注册失效。
• Warden中间件（Devise依赖）的顺序若覆盖OmniAuth，可能拦截请求，但从你的中间件栈看，OmniAuth::Builder位于Warden::Manager之后、Rails路由之前，顺序是合规的。

核心问题排查与修复 #

1. 缺失Basecamp OmniAuth策略gem

OmniAuth本身不包含Basecamp的授权策略，必须单独安装对应gem：

# 在Gemfile中添加
gem 'omniauth-basecamp'

执行bundle install后重启服务器。

2. 初始化器参数名错误

Basecamp OAuth应用使用的参数是client_id和client_secret，而非你配置的public_key/private_key，这会导致策略初始化失败，无法生成路由：

# 修正config/initializers/omniauth.rb
Rails.application.config.middleware.use OmniAuth::Builder do
  provider :basecamp, 
    Rails.application.credentials.omniauth.basecamp[:client_id], 
    Rails.application.credentials.omniauth.basecamp[:client_secret]
end

3. 验证策略是否正确注册

重启服务器后，执行rails middleware，检查输出中是否包含：

use OmniAuth::Builder
  use OmniAuth::Strategies::Basecamp

若未出现该条目，说明初始化器未生效：

• 检查初始化器文件名是否符合Rails加载规则（如命名为omniauth.rb，且未被其他初始化器覆盖）。
• 在Rails控制台执行OmniAuth::Strategies.const_defined?(:Basecamp)，返回false则说明策略gem未正确加载。

4. 替代方案：通过Devise统一管理OmniAuth策略

若担心手动配置冲突，可将Basecamp策略直接配置到Devise中，无需单独的OmniAuth初始化器：

# config/initializers/devise.rb
Devise.setup do |config|
  # 其他Devise配置...
  config.omniauth :basecamp, 
    Rails.application.credentials.omniauth.basecamp[:client_id], 
    Rails.application.credentials.omniauth.basecamp[:client_secret]
end

Devise会自动将策略添加到中间件，此时访问/auth/basecamp即可正常跳转至Basecamp授权页面。

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