starlette 的单元测试推荐使用 testclient,它基于 httpx 实现,允许你在不启动实际 http 服务器的情况下直接调用应用实例。通过实例化 testclient 并传入你的 starlette 或 fastapi 应用对象,你可以模拟 get、post 等请求,并检查返回的状态码和响应体。这种方式运行速度快且隔离性好,非常适合验证路由逻辑和中间件行为。

如何测试带有路径参数的路由
当路由包含路径参数(如 /items/{item_id})时,你需要在构造请求 URL 时显式提供这些参数的值。TestClient 会将这些值填入 URL 中,从而触发对应的路由处理函数。确保你的测试用例覆盖正常值和边界情况,以验证参数解析是否正确。

from starlette.applications import Starlette
from starlette.routing import Route
from starlette.responses import JSONResponse
import asyncio
def homepage(request):
return JSONResponse({"hello": "world"})
def get_item(request):
item_id = request.path_params["item_id"]
return JSONResponse({"item_id": item_id})
app = Starlette(routes=[
Route("/", homepage),
Route("/items/{item_id}", get_item)
])
if __name__ == "__main__":
import uvicorn
uvicorn.run(app, host="0.0.0.0", port=8000)
如何测试异步视图函数
Starlette 原生支持异步视图函数(async def)。在使用 TestClient 时,你无需手动管理事件循环,客户端会自动处理异步调用的调度。只需像调用普通函数一样发送请求,TestClient 会等待异步响应完成并返回结果。这简化了测试代码,使其看起来与同步代码无异。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.testclient import TestClient
from starlette.applications import Starlette
from starlette.routing import Route
from starlette.responses import JSONResponse
async def async_endpoint(request):
await asyncio.sleep(0.1) # 模拟异步操作
return JSONResponse({"status": "ok"})
app = Starlette(routes=[
Route("/async", async_endpoint)
])
client = TestClient(app)
response = client.get("/async")
print(response.status_code) # 输出: 200
print(response.json()) # 输出: {'status': 'ok'}
TestClient 如何处理异常状态码
当应用抛出异常或返回错误状态码时,TestClient 默认不会抛出 Python 异常,而是将 HTTP 错误作为正常的响应对象返回。你可以直接检查 response.status_code 是否为 4xx 或 5xx,并通过 response.text 或 response.json() 获取错误详情。这种设计让你能够断言应用在各种错误场景下的行为是否符合预期。










