starlette 通过 `router` 类处理嵌套路由,核心做法是将子路由实例作为参数传入父路由的构造函数中。这样 starlette 会自动将子路由的路径前缀拼接到父路由路径上,并统一注册所有端点。例如,将 `/api/v1/users` 挂载到 `/api` 下,只需在创建父级 `apirouter` 时指定 `include_router(sub_router, prefix="/v1")`,最终即可通过 `/api/v1/users` 访问。

如何定义带前缀的子路由
定义带前缀的子路由需要实例化一个独立的 `APIRouter` 对象,并在其中注册具体的视图函数。关键在于使用 `include_router` 方法时将这个子路由对象和期望的前缀字符串传递给主路由。这样做的好处是逻辑解耦,每个模块可以独立管理自己的 URL 空间。调用后,子路由中的所有路径都会自动加上该前缀,形成完整的请求路径。

from starlette.routing import Route, Router
from starlette.responses import PlainTextResponse
def home(request):
return PlainTextResponse("Home")
def users_list(request):
return PlainTextResponse("Users List")
# 定义子路由
user_routes = [
Route("/users", users_list),
]
# 定义主路由并包含子路由
app = Router(routes=[
Route("/", home),
Router(routes=user_routes, prefix="/api")
])
预期结果:访问根路径返回 "Home",访问 `/api/users` 返回 "Users List"。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
如何处理同名路由冲突
当不同层级的路由中存在相同路径但不同处理逻辑时,Starlette 按照路由定义的顺序进行匹配,先定义的路由优先被触发。如果需要在同一层级或嵌套结构中区分同名路径,必须确保路径字符串唯一,或者利用中间件在路由匹配前拦截请求。若未做特殊处理,后定义的同名路由永远不会被执行,因为请求会被第一个匹配到的路由截获。

from starlette.routing import Route, Router
from starlette.responses import PlainTextResponse
def old_handler(request):
return PlainTextResponse("Old Handler")
def new_handler(request):
return PlainTextResponse("New Handler")
# 错误示例:同名路径,后者无法访问
app = Router(routes=[
Route("/test", old_handler),
Route("/test", new_handler) # 此路由不可达
])
预期结果:访问 `/test` 始终返回 "Old Handler"。
基于prefix参数的具体拼接行为
在使用 `prefix` 参数时,Starlette 会严格检查前缀是否以斜杠开头。如果前缀不以斜杠开头,它会自动补全;如果已存在斜杠,则直接使用。这种机制确保了路径拼接的一致性。开发者在编写代码时应注意前缀的规范性,避免因缺少斜杠导致路径解析错误,例如 `/api` 与 `api` 在内部处理上虽有容错,但显式规范更利于维护。


















