Starlette路由系统使用详解

夏丽同学_4140

夏丽同学_4140

2026-11-19

335人浏览

原创

starlette的路由系统通过`router`类管理url到处理函数的映射,核心做法是实例化`router`并传入路由列表,每个路由包含路径字符串和对应的异步可调用对象。开发者只需定义好视图函数,将其与正则表达式兼容的路径绑定,即可构建完整的请求分发逻辑。若路径中包含参数,starlette会自动解析并注入到请求上下文或视图签名中,无需手动提取。

Starlette路由系统使用详解

Router如何匹配不同HTTP方法的路由?

Starlette的Router支持按HTTP方法区分路由,通过在创建路由时指定methods参数来实现。例如,将同一个路径分别绑定GET和POST方法,框架会根据请求的方法类型分发到不同的处理函数。这种机制允许在单一URL下处理多种业务逻辑,且互不干扰。开发者需确保每个方法的处理器都符合ASGI接口规范,即接收scope、receive和send三个参数。

Starlette路由系统使用详解

from starlette.routing import Router, Route
from starlette.responses import PlainTextResponse

async def get_handler(request):
    return PlainTextResponse("GET method")

async def post_handler(request):
    return PlainTextResponse("POST method")

# 定义路由列表,指定不同方法
routes = [
    Route("/example", handler=get_handler, methods=["GET"]),
    Route("/example", handler=post_handler, methods=["POST"]),
]

app = Router(routes=routes)

预期结果:发送GET请求至/example返回“GET method”,发送POST请求返回“POST method”。若使用PUT等未定义方法,将触发405错误。路径参数如/user/{id}同样受方法限制,需在对应方法路由中声明。

如何处理路径中的动态参数?

Starlette使用花括号语法{param_name}定义路径参数,并在视图函数中直接作为关键字参数接收。框架自动验证参数类型,若类型不匹配则返回404。例如,路径/items/{item_id:int}要求item_id为整数,非整数输入将被拒绝。开发者无需手动转换类型,Starlette内置了类型检查器。对于复杂路径,可使用正则表达式,但推荐优先使用标准占位符以保持代码可读性。

Starlette 1.5.1
Starlette 1.5.1

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

下载

Starlette路由系统使用详解

from starlette.routing import Router, Route
from starlette.responses import PlainTextResponse

async def get_item(request):
    item_id = request.path_params["item_id"]
    return PlainTextResponse(f"Item ID: {item_id}")

# 定义带类型约束的路由
routes = [
    Route("/items/{item_id:int}", handler=get_item),
]

app = Router(routes=routes)

预期结果:访问/items/123返回“Item ID: 123”,访问/items/abc返回404。路径参数也可不加类型约束,此时默认为字符串。多个参数如/users/{user_id}/posts/{post_id}按顺序注入,顺序必须与路径定义一致。

当路由路径存在前缀冲突时,Starlette如何决定最终响应?

当多个路由路径存在子集关系(如/api和/api/users)时,Starlette依据路由注册顺序进行匹配,优先返回最先注册的路由。若/api先注册,则所有以/api开头的请求均被其捕获,除非显式定义更具体的子路径。为避免歧义,建议将具体路径注册在前,通用路径注册在后。此外,可通过add_route方法动态添加路由,后添加的路由优先级高于先添加的同级路径,但不影响已存在的子路径匹配逻辑。

from starlette.routing import Router, Route
from starlette.responses import PlainTextResponse

async def api_root(request):
    return PlainTextResponse("API Root")

async def api_users(request):
    return PlainTextResponse("Users List")

# 先注册具体路径,再注册通用路径
routes = [
    Route("/api/users", handler=api_users),
    Route("/api", handler=api_root),
]

app = Router(routes=routes)

预期结果:访问/api/users返回“Users List”,访问/api返回“API Root”。若交换注册顺序,/api/users可能被/api捕获导致404,除非/api路由内部进一步分发。实际行为取决于路由树的遍历顺序,Starlette采用深度优先匹配,具体路径优先于通配路径。

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API

Python FastAPI 异步开发利用 async/await 关键字,通过定义异步视图函数、使用异步数据库库 (如 databases)、异步 HTTP 客户端 (如 httpx),并结合后台任务队列(如 Celery)和异步依赖项,实现高效的 I/O 密集型 API,显著提升吞吐量和响应速度,尤其适用于处理数据库查询、网络请求等耗时操作,无需阻塞主线程。

2025.12.22

119

5

Python 微服务架构与 FastAPI 框架
Python 微服务架构与 FastAPI 框架

本专题系统讲解 Python 微服务架构设计与 FastAPI 框架应用,涵盖 FastAPI 的快速开发、路由与依赖注入、数据模型验证、API 文档自动生成、OAuth2 与 JWT 身份验证、异步支持、部署与扩展等。通过实际案例,帮助学习者掌握 使用 FastAPI 构建高效、可扩展的微服务应用,提高服务响应速度与系统可维护性。

2026.02.06

594

18

Python Web框架FastAPI 全栈开发教程合集
Python Web框架FastAPI 全栈开发教程合集

以 FastAPI 为核心,讲解现代 Python Web API 的高效开发方式,涵盖路由定义与路径参数/查询参数/请求体绑定、Pydantic 模型的数据校验与序列化、依赖注入(Depends)系统的分层设计、中间件与 CORS 配置、OAuth2 + JWT 认证流程、后台任务(BackgroundTasks)、WebSocket 实时通信、SQLAlchemy 异步 ORM 集成、自动生成 OpenAPI/Swagger 交互文

2026.05.09

796

23

Python FastAPI异步微服务与高性能接口设计
Python FastAPI异步微服务与高性能接口设计

本专题聚焦 Python FastAPI 框架在高性能接口与微服务开发中的应用,讲解异步请求处理、依赖注入机制、路由设计、数据库异步操作以及接口性能优化策略。结合实际项目案例,帮助开发者构建高并发、低延迟的现代化后端服务架构。

2026.06.16

679

12

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

20

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

20

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程