FastAPI测试三大难题：密码验证、异步上下文与认证中间件

1. 项目概述

FastAPI作为Python生态中炙手可热的异步Web框架，以其出色的性能和直观的API设计赢得了大量开发者的青睐。但在实际测试过程中，不少开发者（包括我自己）都曾踩过一些"暗坑"——那些文档中没有明确警告，但一旦遇到就会耗费数小时调试的典型问题。

本文将聚焦三个最具代表性的测试难题：密码哈希验证失效、异步上下文报错和认证中间件异常。这些问题看似简单，但当它们与Pytest测试框架结合时，往往会表现出令人困惑的行为。比如，你可能遇到过明明生产环境正常的密码验证逻辑，在测试用例中却总是返回False；或者精心编写的异步测试代码突然抛出"Event loop is closed"错误。

2. 三大核心问题解析

2.1 密码哈希验证失效

在用户认证测试中，最常见的坑莫过于使用passlib或bcrypt进行密码哈希比对时出现的验证失败问题。根本原因在于测试环境与生产环境对依赖项的加载方式不同。

典型错误现象：

python复制# 生产代码
from passlib.context import CryptContext
pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")

def verify_password(plain_password, hashed_password):
    return pwd_context.verify(plain_password, hashed_password)

# 测试代码
def test_password_verification():
    plain_pwd = "secret"
    hashed_pwd = pwd_context.hash(plain_pwd)
    assert verify_password(plain_pwd, hashed_pwd)  # 有时会意外失败

问题根源：

1. Pytest默认会重新导入模块，可能导致CryptContext实例被多次初始化
2. 测试套件并行执行时，不同测试用例可能共享不兼容的哈希上下文

解决方案：

python复制# conftest.py中固定加密上下文
import pytest
from passlib.context import CryptContext

@pytest.fixture(scope="session")
def crypto_ctx():
    return CryptContext(schemes=["bcrypt"], deprecated="auto")

# 测试用例
def test_password_verification(crypto_ctx):
    plain_pwd = "secret"
    hashed_pwd = crypto_ctx.hash(plain_pwd)
    assert crypto_ctx.verify(plain_pwd, hashed_pwd)

关键技巧：

• 使用scope="session"确保整个测试会话期间使用同一个上下文实例
• 避免在测试代码中直接调用生产环境的哈希实例
• 对于特别敏感的加密测试，可以mock验证函数以返回预期结果

2.2 异步上下文报错

FastAPI的异步特性与Pytest的配合常常会产生微妙的冲突，最典型的就是"Event loop closed"错误。这种问题通常发生在以下场景：

python复制async def async_function():
    await asyncio.sleep(0.1)
    return "done"

def test_async_code(