starlette 项目创建与基础配置的核心步骤是安装依赖、定义路由与视图函数,并通过 asgi 服务器(如 uvicorn)启动应用。具体做法包括使用 pip install starlette uvicorn 安装必要包,编写包含 starlette 实例和路由映射的 python 脚本,最后运行 uvicorn main:app 即可在本地访问服务。

如何初始化 Starlette 应用并注册基本路由?
初始化 Starlette 应用需要实例化 Starlette 类,并使用 add_route() 方法将 URL 路径与处理函数绑定。开发者需创建一个 Python 文件(如 main.py),导入 Starlette 和 Route,定义一个接收 Request 对象并返回 Response 的异步函数,然后将该函数与路径关联。这样配置后,应用就能响应特定的 HTTP 请求。

from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
import uvicorn
async def homepage(request):
return PlainTextResponse("Hello, World!")
routes = [
Route("/", endpoint=homepage),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)
如何处理动态路径参数?
处理动态路径参数需要在路由定义中使用尖括号语法,例如 /users/{user_id}。Starlette 会自动解析 URL 中的变量,并将其作为关键字参数传递给视图函数。开发者只需在视图函数的签名中添加对应的参数名,框架便会自动注入值。这种方式允许构建灵活的资源导向 API,无需手动解析 URL 字符串。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import uvicorn
async def get_user(request):
user_id = request.path_params["user_id"]
return JSONResponse({"user_id": user_id, "status": "found"})
routes = [
Route("/users/{user_id}", endpoint=get_user),
]
app = Starlette(routes=routes)
if __name__ == "__main__":
uvicorn.run(app, host="127.0.0.1", port=8000)
当请求路径未匹配任何路由时,Starlette 默认返回什么结果?
当请求路径未匹配任何已注册的路由时,Starlette 默认返回一个状态码为 404 的 HTML 错误页面。这是内置的错误处理机制,旨在向客户端明确指示资源不存在。开发者可以通过自定义 on_startup 或中间件来修改这一行为,但在基础配置下,未匹配的路径必然触发 404 响应。










