本文介绍如何通过 pytest 的类级 fixture（scope="class" + autouse=True）在测试类中一次性获取并复用 JWT Token，避免每个测试方法重复登录，提升测试效率与可维护性。
本文介绍如何通过 pytest 的类级 fixture（`scope="class"` + `autouse=true`）在测试类中一次性获取并复用 jwt token，避免每个测试方法重复登录，提升测试效率与可维护性。
在编写针对受保护 API 接口的 pytest 测试时，频繁执行登录流程（如调用 /auth/login 获取 JWT）不仅冗余，还降低测试执行速度，并可能因并发或状态干扰引发不稳定问题。理想方案是：在测试类初始化阶段完成一次认证，将生成的 Authorization 头复用于所有测试方法。
关键在于正确使用 @pytest.fixture 的作用域与自动启用机制。以下是推荐实现方式：
✅ 正确做法：使用 autouse=True 的类级 fixture 注入共享状态
import pytest
class TestSecured:
# 自动在类加载时执行，且仅运行一次
@pytest.fixture(scope="class", autouse=True)
def setup_class(self, setup_user_and_token, client, auth):
# 将 fixture 返回值绑定到类属性（非实例属性），供所有测试方法访问
self.__class__._auth_headers = setup_user_and_token
self.__class__._client = client
self.__class__._auth = auth
def test_get_operations(self):
response = self._client.get(f'{SECURED_ROUTE}get-operations', headers=self._auth_headers)
assert response.status_code == 200
def test_post_operation(self):
response = self._client.post(
f'{SECURED_ROUTE}create-operation',
json={"name": "test"},
headers=self._auth_headers
)
assert response.status_code == 201
def test_post_ope2(self):
response = self._client.post(
f'{SECURED_ROUTE}update-operation',
json={"id": 1, "status": "done"},
headers=self._auth_headers
)
assert response.status_code == 200
⚠️ 注意事项：
- 移除 @pytest.mark.usefixtures：该装饰器会强制注入 fixture，但与 autouse=True 冲突，且无法直接赋值给类属性；应完全删除。
- 使用 self.__class__ 而非 self 绑定：确保属性属于类而非单个测试实例，使所有方法共享同一份 token 和 client。
- fixture 依赖顺序需明确：setup_user_and_token 本身依赖 auth，而 auth 依赖 client，pytest 会自动解析依赖链，无需手动管理。
- Token 有效期需匹配测试周期：确保 JWT 过期时间 ≥ 单个测试类执行耗时（通常几秒内），否则需增加刷新逻辑。
? 替代方案（更推荐）：封装为 classmethod + setUpClass
若偏好显式控制、避免 fixture 魔法行为，也可改用标准 unittest 风格（仍兼容 pytest）：
class TestSecured:
@classmethod
def setup_class(cls):
# 手动触发 fixture 调用（pytest 仍管理其生命周期）
from conftest import setup_user_and_token, client, auth
# 注意：需在 conftest.py 中确保这些 fixture 可被导入（推荐保持 fixture 在测试作用域内）
cls._auth_headers = setup_user_and_token(auth())
cls._client = client(create_app({'TESTING': True}))
但该方式破坏了 pytest fixture 的依赖注入优势，强烈建议优先采用 autouse=True fixture 方案。
✅ 总结
- 使用 @pytest.fixture(scope="class", autouse=True) 是实现类级共享资源（如 JWT Token）的标准、简洁且可靠的方式；
- 通过 self.__class__._xxx 绑定，确保所有测试方法访问同一份认证上下文；
- 删除冗余的 @pytest.mark.usefixtures 和重复的 fixture 参数声明，使测试方法签名更干净；
- 此模式适用于任何需前置初始化的场景（如数据库连接池、Mock 服务启动等），具备良好扩展性。
遵循以上实践，你的 TestSecured 类将真正实现“一次登录、多次复用”，兼顾可读性、性能与可维护性。
