在Rails 7的RSpec测试中修改Session数据实现认证用户测试

我正在为Ruby on Rails应用编写RSpec测试，当前使用Google进行身份认证。添加认证前测试均正常运行，但现在需要测试已认证用户场景。以下是我的测试代码示例：

require 'rails_helper'

RSpec.describe 'Test', type: :request do
  it 'should return 200' do
    get '/test'
    expect(response).to have_http_status(:ok)
  end
end

当前该测试返回401状态码，符合预期。

我需要将认证信息写入session变量，让控制器识别用户已登录，但似乎无法在RSpec中直接修改session变量。我可以创建测试用Google账号并编写登录助手，但认为应有更优的测试方式。网上的示例多针对旧版Rails，我当前使用Rails 7.0.4.3和Ruby 3.2.2。

补充：我的认证代码如下：

class ApplicationController < ActionController::Base
  before_action :require_auth

  private

  def require_auth
    user_id = session[:user_id]

    if !user_id.present?
      head :unauthorized
    else
      @auth_user = User.find(user_id)

      if !@auth_user.present?
        head :unauthorized
      end
    end
  end
end

请问如何在RSpec测试中修改Session数据来模拟已认证用户？

因为你是基于session[:user_id]自行实现的认证逻辑，在Rails 7的RSpec请求测试中，无需模拟Google登录流程，直接通过请求方法的session参数即可注入认证所需的session数据，具体步骤如下：

1. 直接在请求中传入session参数 #

创建测试用户后，在发起请求时通过session参数传入user_id，控制器就能读取到该session值并识别用户已认证：

require 'rails_helper'

RSpec.describe 'Test', type: :request do
  it 'returns 200 for authenticated users' do
    # 创建符合模型校验规则的测试用户
    user = User.create!(email: 'test@example.com', password_digest: BCrypt::Password.create('test123'))

    # 发起请求时传入session参数
    get '/test', session: { user_id: user.id }

    expect(response).to have_http_status(:ok)
  end

  it 'returns 401 for unauthenticated users' do
    get '/test'
    expect(response).to have_http_status(:unauthorized)
  end
end

2. 提取为辅助方法（复用场景） #

如果多个测试用例都需要模拟登录，可以将认证逻辑提取为全局辅助方法：

1. 在spec/support/request_helpers.rb中添加如下代码：

module RequestHelpers
  def sign_in(user)
    session[:user_id] = user.id
  end
end

RSpec.configure do |config|
  config.include RequestHelpers, type: :request
end

2. 之后在测试中直接调用sign_in方法即可：

require 'rails_helper'

RSpec.describe 'Test', type: :request do
  let(:user) { User.create!(email: 'test@example.com', password_digest: BCrypt::Password.create('test123')) }

  it 'returns 200 for authenticated users' do
    sign_in(user)
    get '/test'
    expect(response).to have_http_status(:ok)
  end
end

原理说明 #

Rails的RSpec请求测试（type: :request）允许通过请求方法的session参数直接注入session哈希，这些数据会被控制器的session对象读取，完全适配你当前的require_auth认证逻辑，无需额外修改控制器代码。

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