使用TestClient测试FastAPI接口返回522错误，求原因分析

针对你遇到的API线上正常但TestClient测试返回522的问题，排查方向如下：

• TestClient初始化错误：你直接将APIRouter实例传给了TestClient，但TestClient需要接收完整的FastAPI应用实例才能正确工作。正确的做法是先创建FastAPI app，再把router注册到app上，最后用TestClient(app)初始化客户端。示例代码：

  from fastapi import FastAPI, APIRouter
  from fastapi.testclient import TestClient
  
  router = APIRouter()
  # 在此添加你的路由端点逻辑
  
  app = FastAPI()
  app.include_router(router)  # 必须将router挂载到app实例上
  
  client = TestClient(app)  # 使用app实例初始化TestClient
  

  直接传router会导致路由无法被正确识别，内部请求处理异常，可能返回类似522的错误。

• 测试环境依赖配置异常：如果你的API路由依赖外部服务（比如数据库、第三方鉴权接口等），测试环境中这些服务不可用或配置错误，会导致请求处理超时。线上环境配置正常所以能正常运行，但测试时因依赖超时触发了类似522的错误码。

• 请求鉴权信息无效：测试代码里的authorization字段是硬编码的'token'，如果线上使用的是有效令牌，而测试时这个无效令牌触发了后端的异常处理逻辑（比如调用鉴权服务超时），也可能返回522。可以尝试替换为测试环境的有效令牌再测试。

• 路由路径配置不匹配：检查router的挂载前缀是否和测试请求的路径一致。比如如果router是用app.include_router(router, prefix="/api")注册的，那测试时请求路径应该对应"/api/xxx"；如果没有设置前缀，直接请求根路径对应的端点即可。路径不匹配可能导致后端内部处理异常。

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