使用RSpec+Capybara+Puma遇路由错误：No route matches [GET] "/login"

问题现象 #

运行Capybara测试Vue前端时，Puma抛出了路由错误：

Failure/Error: raise ActionController::RoutingError, "No route matches [#{env['REQUEST_METHOD']}] #{env['PATH_INFO'].inspect}"
ActionController::RoutingError: No route matches [GET] "/login"

问题分析 #

这个错误的核心是Rails无法找到/login这个GET请求对应的后端路由，结合你用Vue做前端的场景，大概率是前端路由和Rails后端路由的衔接出了问题，具体可能有这几种情况：

• Rails未配置路由回退：Vue使用前端路由（比如history模式）时，浏览器会直接向Rails发送/login的GET请求，如果Rails没把这些未定义的路径指向Vue入口页面，就会判定为无效路由报错。
• 前端跳转逻辑未生效：点击"Log In"按钮后，前端路由可能还没完成跳转，Capybara就尝试请求/login；或者按钮的跳转路径写错了（比如hash模式下应该是/#/login）。
• 后端路由缺失：如果/login确实需要后端渲染，但你的routes.rb里没定义对应的路由，不过这种情况在Vue前端场景中概率较低。

修复方案 #

1. 配置Rails路由回退到Vue入口页面

打开config/routes.rb，添加通配符路由，将所有未匹配的HTML请求指向Vue的入口页面（一般是根路径对应的控制器动作）：

Rails.application.routes.draw do
  # 你的其他后端路由（如API接口）放在前面
  root 'home#index' # 确保这是Vue应用的入口页面
  # 关键：仅拦截HTML格式的未匹配GET请求，避免影响API接口
  get '*path', to: 'home#index', constraints: ->(req) { req.format.html? }
end

2. 优化测试中的等待逻辑

不要用sleep 1这种硬等待，Capybara支持自动等待元素出现，替换成更可靠的断言：

scenario "User logs in with correct credentials" do
  visit root_path
  save_screenshot
  click_on 'Log In'
  # 等待登录页面的标志性元素出现（替换成你页面的实际内容）
  expect(page).to have_content('登录')
  save_screenshot
end

3. 检查Vue路由配置

• 如果Vue用的是hash模式，确认按钮跳转路径是/#/login而非/login；
• 如果是history模式，必须确保第一步的路由回退配置生效，否则刷新页面也会出现相同错误。

4. 可选：更换更现代的JS驱动

Poltergeist已停止维护，对现代JS特性支持有限，建议换成selenium_chrome_headless：
在rails_helper.rb中修改配置：

# 移除 require "capybara/poltergeist"
Capybara.javascript_driver = :selenium_chrome_headless

（需确保系统已安装Chrome和ChromeDriver）

附相关代码 #

rails_helper.rb

ENV['RAILS_ENV'] ||= 'test'
require File.expand_path('../../config/environment', __FILE__)
abort("The Rails environment is running in production mode!") if Rails.env.production?
require 'spec_helper'
require 'rspec/rails'
require "pundit/rspec"
require "capybara/rails"
require "capybara/rspec"
require "capybara/poltergeist"
require 'database_cleaner'
require 'factory_girl'
require 'shoulda/matchers'
require "paperclip/matchers"
require 'support/spec_helpers/warden_controller_helpers'
require 'webmock/rspec'
require 'support/spec_helpers/webmock_helper'
Capybara.javascript_driver = :poltergeist

login_spec.rb

require 'rails_helper'
RSpec.feature "User login", type: :feature, js: true do
  before :each do
    @user = User.create!(
      first_name: "Bob",
      last_name: "Brown",
      email: "bob@email.com",
      password: "bob1",
      has_accepted_terms: true
    )
  end
  scenario "User logs in with correct credentials" do
    visit root_path
    save_screenshot
    click_on 'Log In'
    sleep 1
    save_screenshot
  end
end

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