FastAPI单元测试实战，TestClient用对了吗？别等上线被喷才后悔！

🎯 摘要：你是不是也遇到过——改了一行代码，结果线上某个接口悄悄崩了？测试全靠 postman 手点？今天手把手带你用FastAPI的 TestClient 写出靠谱单元测试，把bug扼杀在摇篮里。 咱们先问个扎心的问题：你上次写完一个新接口，是不是直接postman跑通就美滋滋地推到生产了？😎 然后半夜被报警电话吵醒，发现一个你没测到的边界条件炸了，用户数据乱飘，老板发火，你还要一边道歉一边修bug…… 单元测试不是给领导看的，是给自己的代码上保险。 今天咱们不聊虚的，直接撸袖子，把FastAPI的TestClient从安装到排雷全讲明白。 📌 本文能帮你解决什么 ✅ 快速搭建FastAPI项目的单元测试环境，不再手动模拟请求 ✅ 掌握 TestClient 的常用方法（GET/POST/文件上传/依赖项覆盖） ✅ 避开我踩过的3个大坑：数据库连接、异步测试、依赖注入 ✅ 写出可维护、能快速定位问题的测试代码，自信重构 🔧 第一部分：TestClient 到底是什么？ 你可能会问：“单元测试难道不是用 requests 库去怼我本地启动的服务吗？” 那样太慢且耦合重！ FastAPI自带的 TestClient 基于 Starlette 的测试框架，直接复用你app的实例，不需要真正启动服务器。 就像你吃火锅不用先把锅烧开再涮肉，而是直接在后厨试吃——速度快、隔离好，而且能精准mock依赖。 💡 我的个人心得：把TestClient当成你写的每个接口的“贴身保镖”。你每加一个路由，就应该立刻写一个保镖测试用例，确认它能正常干活。 🚀 第二部分：3分钟搭好测试架子（含安装） 1. 安装测试必备库 pip install pytest httpx pytest-asyncio # TestClient 是 fastapi.testclient 自带的，但依赖 httpx 很多教程只让你装 pytest，但忽略了一点：FastAPI 的 TestClient 底层需要 httpx，如果你用异步端点，一定记得装 pytest-asyncio。别学我当初只装 pytest 然后疯狂报错“loop already running”，气得差点砸电脑。 2. 最小示例：测试一个“Hello World” # app/main.py from fastapi import FastAPI app = FastAPI() @app.get("/") def read_root(): return {"msg": "Hello FastAPI"} # tests/test_main.py from fastapi.testclient import TestClient from app.main import app client = TestClient(app) def test_read_root(): response = client.get("/") assert response.status_code == 200 assert response.json() == {"msg": "Hello FastAPI"} # 在项目根目录执行 uv run -m pytest 看到没？直接 client.get("/")，就像前端发请求一样简单，但速度快到飞起⚡️。 🧪 第三部分：实战演练——那些常用到爆的测试方法 🎯 场景1：POST 请求 + JSON 数据 假设你有一个创建用户的接口，需要传body。写测试时，直接模拟真实请求体： def test_create_user(): payload = {"name": "小媛", "email": "yuan@coder.com"} response = client.post("/users/", json=payload) assert response.status_code == 201 data = response.json() assert data["name"] == "小媛" assert "id" in data 关键点：一定要用 json= 参数传字典，而不是 data=，后者默认是表单编码，后端用pydantic模型接会报422！别问我怎么知道的……那次我排查了半小时才发现传参方式错了。