路由不主动编码,只匹配已解码的URL;编码应在构造URL时由客户端或上层协议完成,如前端用encodeURIComponent,后端用URLEncoder等。

路由本身不主动做百分比编码,它只负责解析已编码的 URL 字符串。真正处理编码与转义的是上层协议、客户端构造逻辑或服务端接收前的解码环节。
路由看到的永远是已解码后的路径片段
现代 Web 框架(如 Express、Next.js、Spring MVC)在请求到达路由匹配阶段前,HTTP 服务器(如 Node.js 的 http 模块、Nginx、Tomcat)通常已完成一次标准的 URL 解码。也就是说:
- 浏览器发送
/api/search?q=%E4%B8%AD%E6%96%87&tag=foo%2Bbar - 服务端收到时,
req.url或request.getRequestURL()中的路径和查询参数往往已是解码态(如q=中文、tag=foo+bar) - 路由匹配基于这个解码后的字符串进行,比如匹配
/api/search,而不是/api%2Fsearch
哪些字符必须编码?路由为何不自己 encode?
不是所有字符都能直接出现在 URL 中。以下三类字符需编码才能安全传输:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
-
保留字符:如
/、?、#、&、=、@、:—— 它们有语法意义,若作普通数据必须编码(例如路径中含user@domain,@要写成%40) -
非 ASCII 字符:中文、日文、emoji 等必须先按 UTF-8 编码为字节流,再对每个字节做
%XX转义(如乐 → E4 B9 90 → %E4%B9%90) -
空格与控制字符:空格在查询参数中常被简化为
+(表单提交规则),但在路径中必须用%20;制表符、换行符等不可见字符一律需转义
不同上下文的编码规则并不统一
同一个字符,在 URL 不同位置可能有不同合法表示方式:
-
路径段中空格 → 只能是
%20,+是非法的 -
查询参数值中空格 →
+和%20都被广泛接受(但 RFC 3986 推荐%20;+来自早期表单编码 RFC 1866) -
查询参数键名含
/→ 必须编码为%2F,否则会被路由解析器截断为不同层级 - Fragment(# 后)内容 → 浏览器不会自动编码,也不参与服务端路由,需手动处理
开发者该在哪一层控制编码?
编码动作应发生在「构造 URL」那一刻,而非路由定义或匹配时:
-
前端 JS:用
encodeURIComponent()处理动态拼接的路径段或参数值(encodeURI()不编码/、?,适合整 URL;encodeURIComponent()更安全) -
后端生成跳转链接:Java 用
URLEncoder.encode(str, "UTF-8");Python 用urllib.parse.quote(str, safe='');Go 用url.PathEscape()或url.QueryEscape() -
框架自动处理场景:Alamofire、Axios、Spring
@RequestParam默认完成解码;但路径变量(如 Express/:id)若含特殊字符,仍需确保客户端已正确编码










