RSpec请求测试CRUD时仅首个用例成功其余失败求助

问题描述 #

编写RSpec请求测试用例测试部门CRUD操作时，出现以下问题：

• 无论将哪个请求放在首位，该请求会成功，后续所有请求均返回401 Unauthorized失败。例如当前代码中GET请求成功、POST失败；调换context块顺序后，POST成功、GET失败。
• 仅当所有请求放在同一个it块中才能全部通过，但这不符合测试规范（只能得到1个通过示例）。
• 尝试在每个块中重新登录用户，问题依旧，不确定是api_key失效还是与cancancan分配的system_admin角色有关。

原因分析 #

1. 全局共享实例导致状态混乱：当前代码中user和role用FactoryBot.build创建（仅在内存中，未持久化到数据库），且定义在describe块外部，属于全局共享对象，多个测试用例会复用同一个实例，导致会话或api_key状态异常。
2. 未持久化对象导致权限校验失败：build生成的对象未保存到数据库，cancancan进行权限验证时无法从数据库读取角色信息，触发权限拦截。
3. 固定headers复用api_key：全局定义的headers变量会在所有测试中复用同一个api_key，可能因会话过期或状态变更导致后续请求失效。

解决方案 #

1. 使用let定义独立测试实例，确保每个测试用例生成全新的用户和角色。
2. 用FactoryBot.create替代build，将对象持久化到数据库，保证cancancan能读取到角色信息。
3. 动态生成headers，确保每个测试使用当前用户的api_key。
4. 在before块内完成角色添加和用户登录，保证每个测试的初始状态一致。

修改后的测试代码 #

require 'rails_helper'

RSpec.describe "Departments", type: :request do
  let(:role) { FactoryBot.create(:role, name: "system_admin") }
  let(:user) { FactoryBot.create(:user) }
  let(:headers) { { "x-app-api-key" => user.api_key } }

  before do
    user.add_role(role.name)
    sign_in user
  end
  
  describe "CRUD /v1/departments" do
    context "GET" do
      it "returns successful response" do
        get api_departments_path, headers: headers
 
        expect(response.content_type).to eq("application/json; charset=utf-8")
        expect(response).to have_http_status(:success)
      end
    end

    context "POST" do
      it "creates a department successfully" do
        post api_departments_path, headers: headers, params: { name: "department" }

        expect(response.content_type).to eq("application/json; charset=utf-8")
        expect(response).to have_http_status(:success)
      end
    end
  end
end

改动说明 #

• let是RSpec的延迟加载变量，每个测试用例执行时都会重新生成实例，彻底隔离测试状态。
• FactoryBot.create将对象保存到数据库，确保cancancan权限验证能正常读取角色，同时用户的api_key也会被正确持久化。
• before块在每个测试前执行，确保用户每次都被正确添加角色并登录，初始状态一致。
• headers基于当前测试的用户动态生成，避免共享api_key导致的状态问题。

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