快速安装并运行 starlette 的核心做法是:使用 pip 安装 starlette 及其依赖库 uvicorn,然后编写一个包含路由和应用的 python 脚本,最后通过 uvicorn 启动该应用。具体而言,你需要在终端执行 pip install starlette uvicorn,创建一个名为 main.py 的文件,定义一个 starlette 实例并添加路由,接着运行 uvicorn main:app 即可在本地 http://127.0.0.1:8000 访问服务。

如何配置 Starlette 的路由以处理不同的 HTTP 方法
配置 Starlette 路由以处理不同 HTTP 方法的关键在于使用 add_route 或装饰器 @app.route() 时指定 methods 参数。Starlette 默认只处理 GET 请求,若需支持 POST、PUT 等,必须在路由注册时显式声明。例如,通过 app.add_route("/data", data_handler, methods=["POST"]) 可以确保只有 POST 请求能触发 data_handler 函数,其他方法将返回 405 Method Not Allowed 错误。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import uvicorn
async def homepage(request):
return JSONResponse({"message": "Hello World"})
async def create_item(request):
body = await request.json()
return JSONResponse({"received": body})
routes = [
Route("/", endpoint=homepage, methods=["GET"]),
Route("/items", endpoint=create_item, methods=["POST"]),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)预期结果:发送 GET / 返回 {"message": "Hello World"};发送 POST /items 返回接收到的 JSON 数据;发送 GET /items 返回 405 Method Not Allowed。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
如何在 Starlette 中处理异步请求与同步代码的冲突
在 Starlette 中处理异步请求与同步代码冲突的方法是避免在异步端点(async def)中直接调用阻塞式的同步 I/O 操作,或使用 run_in_executor 将同步代码放入线程池执行。Starlette 基于 asyncio,若在异步上下文中执行如 time.sleep() 或同步数据库查询,会阻塞整个事件循环,导致其他请求无法处理。正确的做法是使用异步库(如 httpx 代替 requests),或将同步函数包装在 loop.run_in_executor(None, sync_func) 中。

import asyncio
from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
import uvicorn
# 模拟一个耗时的同步操作
def slow_sync_task():
import time
time.sleep(2)
return "Sync Task Done"
async def async_endpoint(request):
# 正确方式:在线程池中运行同步代码
loop = asyncio.get_event_loop()
result = await loop.run_in_executor(None, slow_sync_task)
return PlainTextResponse(result)
routes = [
Route("/sync", endpoint=async_endpoint, methods=["GET"]),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)预期结果:访问 /sync 时,服务器不会阻塞,而是将 slow_sync_task 放入线程池,约 2 秒后返回 Sync Task Done,同时其他请求可正常响应。
当 Starlette 应用接收到未定义路径的请求时会返回什么状态码
当 Starlette 应用接收到未定义路径的请求时,它会返回 404 Not Found 状态码。这是 Starlette 的默认行为,因为所有路由都通过 Starlette 实例中的 routes 列表显式注册,任何不在该列表中的路径都不会被匹配,从而触发默认的 404 响应。开发者可以通过自定义 on_startup 或中间件来修改这一行为,但默认情况下,未匹配的路径一律返回 404。

















