starlette 通过基于 asyncio 的事件循环机制处理高并发连接,利用 python 的协程特性实现单线程下的非阻塞 i/o。它通常部署在 uvicorn 或 hypercorn 等 asgi 服务器上,由服务器负责底层的网络监听与协议解析,而 starlette 应用层则专注于路由分发和逻辑执行。这种架构使得单个进程即可高效处理成千上万的并发请求,无需为每个连接创建独立的操作系统线程。

ASGI 服务器如何接收并转发请求
Starlette 本身不包含网络监听代码,而是依赖符合 ASGI 标准的服务器(如 Uvicorn)来建立 TCP 连接。当客户端发起 HTTP 请求时,Uvicorn 接收数据并将其封装为 ASGI 实例,随后调用 Starlette 应用的 __call__ 方法。这一过程是异步的,服务器在等待 I/O 操作完成期间可以处理其他连接,从而避免线程阻塞。

import asyncio
from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
async def homepage(request):
# 模拟一个非阻塞的异步操作
await asyncio.sleep(0.1)
return PlainTextResponse("Hello World")
routes = [
Route("/", homepage),
]
app = Starlette(routes=routes)
中间件如何处理并发上下文
Starlette 的中间件系统基于异步生成器或可调用对象,允许在请求进入路由之前和响应返回之后插入自定义逻辑。每个中间件实例在处理特定请求时会获得一个独立的上下文环境,确保并发请求之间的状态隔离。开发者可以通过继承 BaseHTTPMiddleware 或直接实现 ASGI 接口来添加认证、日志记录或缓存等功能,这些操作同样遵循非阻塞原则,不会降低整体吞吐量。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.middleware.base import BaseHTTPMiddleware
class CustomMiddleware(BaseHTTPMiddleware):
async def dispatch(self, request, call_next):
# 在请求发送前执行逻辑
start_time = asyncio.get_event_loop().time()
# 继续处理请求
response = await call_next(request)
# 在响应返回后执行逻辑
process_time = asyncio.get_event_loop().time() - start_time
response.headers["X-Process-Time"] = str(process_time)
return response
WebSocket 连接的生命周期管理
Starlette 对 WebSocket 的支持同样基于异步模型,允许在同一个端口上混合处理 HTTP 和 WebSocket 流量。当 WebSocket 连接建立时,Starlette 会创建一个持久的会话对象,开发者可以在该会话中异步发送和接收消息。由于所有操作都是非阻塞的,服务器可以在维持大量长连接的同时,继续响应其他普通的 HTTP 请求,从而实现高效的资源利用。










