starlette 安装与配置实战的核心在于通过 pip 安装依赖并实例化 starlette 应用对象,随后使用 add_route 注册路由或挂载 router 以处理 http 请求。开发者只需在本地环境运行 pip install starlette uvicorn 即可获取核心库与 asgi 服务器,接着创建应用实例并定义路径映射,最后通过 uvicorn main:app 启动服务即可实现功能。

如何正确安装 Starlette 及其依赖
安装 Starlette 需要同时获取框架本身和符合 ASGI 标准的服务器,通常推荐使用 uvicorn。执行 pip install starlette uvicorn 命令后,系统会自动解析并安装所有底层依赖,包括 anyio 用于异步支持以及 sniffio 等工具库。安装完成后,可以通过导入 starlette.applications 模块来验证安装是否成功,若未抛出异常则说明环境已就绪。

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
import sys
try:
from starlette.applications import Starlette
from starlette.routing import Route, Router
print("Installation successful")
except ImportError as e:
print(f"Import failed: {e}")
sys.exit(1)
如何配置基础路由与中间件
配置路由时,开发者应实例化 Starlette 类并传入 routes 参数,该参数接受一个包含 Route 对象的列表。每个 Route 对象需指定 URL 路径字符串、对应的处理函数以及可选的 HTTP 方法。若需添加中间件,可通过 add_middleware 方法链式调用,例如使用 Middleware 类包装自定义逻辑或内置的 CORSMiddleware,这些中间件将在请求到达路由处理器之前或之后执行。
from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
async def homepage(request):
return PlainTextResponse("Hello World!")
routes = [
Route("/", endpoint=homepage),
]
app = Starlette(routes=routes)
当请求路径不匹配任何注册路由时会发生什么
当客户端发送的请求路径未在 routes 列表中注册时,Starlette 会默认返回一个状态码为 404 的响应。具体而言,框架内部的 NotFound 异常会被捕获并转换为 PlainTextResponse,其内容为 "Not Found"。这种行为是内置的默认机制,无需额外配置即可生效,确保未定义的路径能给出明确的错误反馈而非直接崩溃。










