
本文介绍如何使用 aiohttp 的正则路由捕获任意长度的路径片段,并将其安全、高效地解析为字符串列表,适用于 restful 接口设计中需接收可变数量路径参数的场景。
本文介绍如何使用 aiohttp 的正则路由捕获任意长度的路径片段,并将其安全、高效地解析为字符串列表,适用于 restful 接口设计中需接收可变数量路径参数的场景。
在构建异步 Web 服务时,常需支持类似 /args/a/b/c/d 这样长度不固定的路径结构。aiohttp 原生不支持直接声明“可变长路径段”(如 /{*args}),但可通过正则路由变量(regex capture) 灵活实现该能力。
核心思路是:利用 {name:regex} 语法定义一个匹配任意后续路径的命名组,再在请求处理函数中对捕获的完整子路径进行分割与清洗。
以下为推荐实现方式:
from aiohttp import web
async def handle_dynamic_args(request):
# 捕获 /args/ 后的所有路径部分(不含开头和结尾斜杠)
raw_path = request.match_info.get('args', '')
# 安全分割:过滤空字符串(避免 // 或末尾 / 导致空项)
args_list = [part for part in raw_path.split('/') if part]
return web.Response(
text=f"args = {args_list!r}",
content_type='text/plain'
)
app = web.Application()
# 使用正则 {args:.*} 匹配 /args/ 后全部内容(包括中间所有 /)
app.add_routes([web.get('/args/{args:.*}', handle_dynamic_args)])
启动服务后,访问:
http://localhost:8080/args/r/a/n/d/o/m/1/2/3
将返回:
args = ['r', 'a', 'n', 'd', 'o', 'm', '1', '2', '3']
✅ 关键说明:
-
{args:.*}中的.*是正则表达式,表示“匹配任意字符(含/)零次或多次”,从而捕获整个剩余路径; -
raw_path.split('/')会将形如"r/a/n/d/o/m/1/2/3"拆分为['r','a','n','d','o','m','1','2','3']; - 使用列表推导式
[p for p in ... if p]可自动跳过因双斜杠(//)或路径结尾/产生的空字符串,提升鲁棒性。
⚠️ 注意事项:
- 该路由具有高优先级,应置于其他更具体路由之后,避免意外覆盖(例如
/args/static可能被/{args:.*}错误匹配); - 若需严格限定路径段为非空 ASCII 字符,可改用更安全的正则,如
{args:[^/]+(?:/[^/]+)*},但.*在开发阶段更简洁实用; - 生产环境建议增加长度校验(如
if len(args_list) > 100: raise web.HTTPBadRequest()),防止恶意超长路径耗尽内存。
通过此方法,你无需为不同参数数量重复注册路由,即可统一处理任意长度的路径参数列表,兼顾灵活性与可维护性。










