Rails集成Spotify API时Mock OmniAuth认证遇路由错误：未初始化常量Auth

你在Mock Spotify认证流程时遇到的这个错误，本质是Rails找不到对应Auth命名的控制器或路由配置不匹配，我帮你一步步排查解决：

1. 确认Auth控制器存在且命名规范 #

首先检查app/controllers目录下有没有对应的控制器文件，比如auth_controller.rb，并且类定义要和文件名对应：

# app/controllers/auth_controller.rb
class AuthController < ApplicationController
  def spotify_callback
    # 这里写Spotify回调后的处理逻辑
  end

  def failure
    # 登录失败的处理逻辑
  end
end

如果你的控制器是放在命名空间下（比如app/controllers/auth/spotify_controller.rb），那类名要写成class Auth::SpotifyController < ApplicationController，后续路由也要对应调整。

2. 检查路由配置是否匹配控制器 #

打开config/routes.rb，确认Spotify登录的回调路由指向了正确的控制器动作。比如：

# config/routes.rb
Rails.application.routes.draw do
  root 'home#index'
  # Spotify登录回调路由
  get '/auth/spotify/callback', to: 'auth#spotify_callback'
  get '/auth/failure', to: 'auth#failure'
end

如果是命名空间控制器，路由要写成：

get '/auth/spotify/callback', to: 'auth/spotify#callback'

可以在终端运行rails routes命令，确认/auth/spotify/callback对应的控制器和动作是否正确。

3. 确保测试环境加载最新路由 #

有时候测试环境可能没自动加载更新后的路由，你可以在测试文件顶部或者rails_helper.rb里添加路由重载：

# 在测试文件开头或rails_helper.rb中
Rails.application.reload_routes!

4. 正确配置OmniAuth Mock（如果用OmniAuth处理认证） #

如果是用OmniAuth对接Spotify，要确保测试环境的Mock配置正确。在rails_helper.rb里添加：

OmniAuth.config.test_mode = true

OmniAuth.config.mock_auth[:spotify] = OmniAuth::AuthHash.new({
  provider: 'spotify',
  uid: 'spotify_user_123',
  info: {
    display_name: 'Test User',
    email: 'test@example.com'
  },
  credentials: {
    token: 'mock_spotify_token',
    refresh_token: 'mock_refresh_token',
    expires_at: 1.hour.from_now.to_i
  }
})

这样测试中点击“Sign in with Spotify”时，会直接触发Mock的认证回调，不会跳转到真实的Spotify登录页。

调整完这些后再运行Capybara测试，应该就能解决uninitialized constant Auth的错误了。

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