Rspec Rails6系统测试：before(:each)全局登录不生效优化方案

• 每个测试用例单独调用login完成登录不是RSpec系统测试的标准实现，这是全局配置失效时的临时妥协写法，重复代码多、长期维护成本高，完全可以通过规范的全局配置消除这类重复逻辑。
• 你之前编写的全局登录前置逻辑不生效，本质是RSpec钩子和辅助方法的作用域匹配没有对齐系统测试的场景，只要调整配置方式，就可以实现全量系统测试自动完成登录前置，不需要逐用例手动调用。

你遇到的“before块不触发浏览器登录流程”的问题，基本都是以下几个配置细节没对齐导致的：

• 没有对全局钩子做测试类型过滤：如果直接在配置里写无范围的before(:each)，钩子会对所有测试类型生效——模型测试、单元测试这类不需要启动浏览器的场景下，强制调用visit这类Capybara专属方法会直接报错，甚至导致整个测试套件执行中断，表现得就像“钩子完全没触发”。很多开发者遇到这种“钩子不执行”的表象，其实是钩子在非系统测试场景下提前报错，RSpec的错误日志会被后续的测试输出覆盖，导致误以为钩子完全失效。
• 辅助方法引入范围太广：无差别全局引入SessionHelper的话，会把依赖浏览器环境的visit、fill_in方法带到所有测试中，非系统测试场景调用这些方法会报未定义错误，打乱正常的测试执行流程。
• 钩子定义位置错误：如果把全局before块直接写在测试文件的顶层，而不是写到RSpec.configure的配置块里，这个钩子不会被注册为全局前置逻辑，自然不会在每个用例执行前触发。

按照下面的步骤调整配置，就能实现所有系统测试自动完成登录前置，不需要在每个用例里重复写login(user)：

1. 调整辅助方法的引入范围，只在系统测试场景生效

   # spec/rails_helper.rb
   RSpec.configure do |config|
     # 不再无差别全局引入SessionHelper，仅对系统测试类型开放登录相关方法
     config.include SessionHelper, type: :system
   end
   

2. 注册仅对系统测试生效的全局前置钩子，统一执行登录逻辑
   在同一个RSpec.configure块内追加配置：

   # 为所有系统测试定义共享的默认user变量，支持单文件覆盖
   config.define_let(:user, type: :system) { create(:user) }
   
   # 仅对type: :system的系统测试生效，不干扰其他类型的测试
   config.before(:each, type: :system) do
     # 自动执行完整的浏览器登录流程，此时Capybara的浏览器会话已经完成初始化，会正常触发页面访问、表单填写、提交的全流程
     login(user)
   end
   

   配置中定义的全局默认用户变量，允许单个测试文件通过重写let(:user)覆盖默认值，灵活适配管理员、受限用户等特殊角色的测试场景。

• 登录相关的前置逻辑完全收敛到一处维护：后续如果登录页的表单字段、路由发生调整，只需要修改SessionHelper里的login方法即可，不需要逐文件修改每个测试用例的重复代码。
• 测试用例本身的逻辑更纯粹：每个用例只需要聚焦于当前要验证的业务校验逻辑，不需要反复书写和核心目标无关的前置操作。

如果遇到需要测试未登录访客场景的用例，可以给用例加自定义标签跳过全局登录逻辑，不需要特意删除全局钩子：

# 在全局钩子中增加判断逻辑
config.before(:each, type: :system) do |example|
  # 给标记了skip_login的用例跳过自动登录
  next if example.metadata[:skip_login]

  login(user)
end

# 用例中使用时直接加标签即可
it '允许未登录用户浏览公开商品列表', skip_login: true do
  visit products_path
  expect(page).to have_content('Products')
end

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