1. FastAPI测试中的三大致命陷阱解析
作为Python生态中增长最快的Web框架之一,FastAPI凭借其异步性能和自动文档生成俘获了大量开发者的心。但在实际测试环节,我踩过的坑比Swagger文档里的端点还多。特别是这三个高频问题:密码哈希验证失效、异步上下文报错和认证中间件失灵,几乎每个FastAPI项目都会遇到。下面就用Pytest武装到牙齿,一次性解决这些顽疾。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 密码哈希的测试噩梦与解决方案
2.1 为什么测试环境总是验证失败?
生产环境跑得好好的Bcrypt密码验证,一到测试用例就罢工。根本原因在于测试时使用的哈希算法与生产环境不一致。FastAPI的TestClient默认不会加载中间件,导致密码哈希对比时使用的salt不一致。
python复制# 典型错误示例
def test_login_fail():
client = TestClient(app)
response = client.post("/login", json={"username": "test", "password": "wrong"})
assert response.status_code == 401 # 可能意外通过!
2.2 正确的哈希测试姿势
需要确保测试时使用相同的密码上下文:
python复制# conftest.py 配置
@pytest.fixture
def test_client():
from passlib.context import CryptContext
pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
app.dependency_overrides[get_password_context] = lambda: pwd_context
yield TestClient(app)
app.dependency_overrides.clear()
# 测试用例
def test_password_hash(test_client):
client = test_client
raw_password = "secret"
hashed = client.app.dependency_overrides[get_password_context]().hash(raw_password)
assert client.app.dependency_overrides[get_password_context]().verify(raw_password, hashed)
关键技巧:在
conftest.py中统一管理密码上下文,避免每个测试文件重复配置
3. 异步地狱:当Pytest遇到async/await
3.1 那些诡异的"Event loop closed"错误
直接测试异步路由时,90%的报错都源于事件循环管理不当。经典错误包括:
- 在同步测试函数中调用异步代码
- 多个测试相互干扰事件循环
- 未正确处理异步依赖项的清理
python复制# 错误示范 - 会导致随机性失败
async def test_async_
