starlette 的高性能配置核心在于利用其异步非阻塞特性,通过 `asgi` 服务器(如 uvicorn)部署并合理设置并发参数。具体做法是确保应用代码中所有 i/o 操作均为异步,避免在事件循环中执行阻塞任务,同时根据服务器 cpu 核心数调整工作进程数量以最大化吞吐量。

如何正确配置 ASGI 服务器以实现高并发
要获得高性能,必须使用支持 ASGI 协议的服务器如 Uvicorn 或 Hypercorn,而非传统的 WSGI 服务器。关键在于启动时指定正确的 workers 数量和线程池大小,通常建议将 workers 设置为 CPU 核心数,以便利用多核并行处理请求。

import uvicorn
from myapp import app
if __name__ == "__main__":
# 假设 CPU 有 4 个核心,设置 4 个工作进程
uvicorn.run(app, host="0.0.0.0", port=8000, workers=4)
上述代码展示了基本的启动方式。当 workers=4 时,Uvicorn 会启动 4 个独立的 Python 进程,每个进程拥有自己的事件循环和内存空间。这种架构能有效利用多核 CPU,显著提升并发处理能力。如果只使用单 worker,即使代码是异步的,也无法充分利用多核资源。此外,对于计算密集型任务,应考虑使用线程池或进程池,因为异步 I/O 主要优化的是等待时间,而非计算速度。
如何处理中间件对性能的影响
中间件在 Starlette 中按注册顺序依次执行,过多的中间件会增加请求处理的延迟。为了保持高性能,应尽量减少中间件的数量,并将轻量级的中间件放在前面,重量级的放在后面。同时,避免在中间件中执行同步阻塞操作。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.applications import Starlette
from starlette.middleware import Middleware
from starlette.middleware.cors import CORSMiddleware
from starlette.middleware.trustedhost import TrustedHostMiddleware
# 定义中间件列表
middleware = [
Middleware(TrustedHostMiddleware, allowed_hosts=["example.com"]),
Middleware(CORSMiddleware, allow_origins=["*"]),
]
app = Starlette(middleware=middleware)
在这个例子中,TrustedHostMiddleware 和 CORSMiddleware 被添加到应用中。由于它们都是基于 Starlette 的标准实现,且逻辑简单,因此对性能影响较小。但如果自定义了复杂的中间件,例如进行数据库查询或文件读写,务必确保这些操作是异步的。否则,一个阻塞的中间件会拖慢整个请求链,导致其他并发请求无法及时处理。最佳实践是将耗时操作移至后台任务或使用缓存机制,以减少中间件的负担。
在路由处理函数中使用 await 是否必要
在 Starlette 的路由处理函数中,如果涉及 I/O 操作(如数据库查询、HTTP 请求),必须使用 await 关键字调用异步函数。如果不使用 await,直接调用异步函数只会返回一个协程对象,而不会真正执行该操作,这会导致逻辑错误或数据缺失。对于纯计算逻辑,则不需要 await。
以下代码演示了如何在路由中正确使用 await:
from starlette.responses import JSONResponse
import httpx
async def get_data(request):
# 错误用法:直接调用异步函数
# response = httpx.AsyncClient().get("https://api.example.com/data")
# 正确用法:使用 await
async with httpx.AsyncClient() as client:
response = await client.get("https://api.example.com/data")
return JSONResponse({"data": response.json()})
在上述代码中,httpx.AsyncClient().get() 是一个异步操作,必须通过 await 来等待其完成。如果省略 await,response 变量将是一个未执行的协程对象,后续对其调用 .json() 方法会引发异常。此外,使用 async with 上下文管理器可以确保客户端连接被正确关闭,避免资源泄漏。对于不涉及 I/O 的简单逻辑,如数据转换或计算,可以直接返回结果,无需 await。这种区分有助于保持代码的高效性和正确性。


















