starlette 是一个轻量级的 asgi 框架,非常适合构建高性能的异步 api。要打造这样的 api,你需要安装 starlette 及其依赖库(如 uvicorn),然后定义路由、处理请求和响应。核心做法是创建一个 starlette 应用实例,使用 @app.route() 装饰器或 add_route() 方法注册端点,并在端点函数中处理逻辑。uvicorn 作为 asgi 服务器来运行这个应用。

如何安装 Starlette 并配置开发环境?
安装 Starlette 非常简单,只需使用 pip 即可。为了运行基于 ASGI 的应用,你还需要安装一个 ASGI 服务器,推荐 Uvicorn。创建虚拟环境后,执行 pip install starlette uvicorn 即可完成安装。安装完成后,你可以编写一个简单的脚本,导入 Starlette 和 Request、Response 类,定义一个根路径的路由,返回 JSON 响应。最后,使用 uvicorn main:app 命令启动服务,其中 main 是文件名,app 是应用实例名。

import asyncio
from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
async def homepage(request):
return JSONResponse({"message": "Hello, Starlette!"})
routes = [
Route("/", endpoint=homepage),
]
app = Starlette(routes=routes)
# 在终端运行: uvicorn main:app --reload
预期结果:访问 http://localhost:8000/ 将返回 {"message": "Hello, Starlette!"}。Uvicorn 会监听端口 8000,并支持热重载(--reload)以便开发时自动重启。
如何定义路由和处理不同类型的请求?
Starlette 的路由系统支持多种 HTTP 方法,如 GET、POST、PUT、DELETE 等。你可以通过 @app.route(path, methods=["GET", "POST"]) 装饰器来指定允许的方法。在处理请求时,你可以从 request 对象中获取查询参数、路径参数、JSON 数据或表单数据。例如,处理 POST 请求时,可以使用 await request.json() 解析 JSON 体。对于动态路径,如 /users/{user_id},你可以在端点函数中接收 user_id 参数。Starlette 会自动将路径参数绑定到函数参数上。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.responses import JSONResponse
from starlette.routing import Route
async def get_user(request):
user_id = request.path_params["user_id"]
return JSONResponse({"user_id": user_id, "name": "Alice"})
async def create_user(request):
data = await request.json()
# 假设这里保存数据
return JSONResponse({"status": "created", "data": data}, status_code=201)
routes = [
Route("/users/{user_id}", endpoint=get_user, methods=["GET"]),
Route("/users", endpoint=create_user, methods=["POST"]),
]
预期结果:GET /users/123 返回 {"user_id": "123", "name": "Alice"};POST /users 发送 {"name": "Bob"} 返回 {"status": "created", "data": {"name": "Bob"}} 且状态码为 201。
如何处理中间件和异常?
Starlette 提供了中间件机制,允许你在请求到达端点之前或之后执行额外逻辑,如日志记录、身份验证或 CORS 处理。你可以使用 app.add_middleware() 添加中间件,它接受一个类和一个可选的关键字参数。对于异常处理,Starlette 允许你注册自定义异常处理器。当发生未捕获的异常时,这些处理器会被调用。你可以定义一个函数,接收 request 和 exc 参数,返回一个 Response 对象。这有助于统一错误响应格式,提升 API 的健壮性。
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.responses import JSONResponse, Response
class LoggingMiddleware(BaseHTTPMiddleware):
async def dispatch(self, request, call_next):
print(f"Request: {request.method} {request.url}")
response = await call_next(request)
print(f"Response: {response.status_code}")
return response
async def custom_exception_handler(request, exc):
return JSONResponse(
status_code=500,
content={"error": str(exc)}
)
app.add_middleware(LoggingMiddleware)
app.add_exception_handler(500, custom_exception_handler)
预期结果:每个请求都会打印日志信息。如果端点抛出异常,将返回 {"error": "异常信息"} 且状态码为 500。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










