FastAPI单元测试中如何使用断点调试？

问题原因 #

TestClient内部通过同步方式执行异步路由，默认的asyncio.run()在VS Code调试器下可能因为PyDev的帧评估优化，导致无法追踪到异步路由函数内的断点。

可行解决办法 #

• 调整VS Code调试配置（推荐）
  在项目的.vscode/launch.json中添加pytest调试配置，关闭PyDev的帧评估优化：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: Pytest",
              "type": "python",
              "request": "launch",
              "module": "pytest",
              "args": ["${file}"],
              "justMyCode": true,
              "env": {"PYDEVD_USE_FRAME_EVAL": "NO"}
          }
      ]
  }
  

  配置完成后，通过这个调试项启动测试，就能正常触发路由内的断点。

• 手动调用异步路由（适合单独调试逻辑）
  如果不想修改调试配置，可以跳过TestClient，直接用asyncio.run()调用路由函数：

  import asyncio
  def test_read_main():
      result = asyncio.run(read_main())
      assert result == {"msg": 2}
  

  注意：这种方式无法模拟真实HTTP请求的上下文（比如请求头、参数解析等），仅适合调试路由内部的业务逻辑。

• 确保用pytest运行测试
  在VS Code中右键测试函数时，选择「Run Test with Pytest」而非「Run Python File」，普通运行模式无法正确加载测试上下文，会导致断点失效。

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