矩阵参数是RFC 3986定义的路径段内分号分隔的name-value对，如/users;version=v2/:id；Echo默认不支持因其依赖Go标准库net/http，而后者完全不解析分号后内容，r.URL.Query()无法获取，路由匹配亦不识别。
什么是矩阵参数，为什么Echo默认不支持
矩阵参数（Matrix Parameters）是RFC 3986定义的一种URL编码方式，写在路径段末尾、分号后，比如 /users;version=v2;format=json/123 中的 ;version=v2;format=json。它和查询参数（?key=val）不同：矩阵参数属于某个路径段的修饰，语义上更贴近“该资源的某种变体”，而非全局请求修饰。
Echo 默认使用 net/http 的标准解析器，而 Go 标准库压根不解析矩阵参数——r.URL.Path 会原样包含分号，r.URL.Query() 完全拿不到它。所以你直接写 GET /users;version=v2/:id，Echo 的路由匹配会失败，或把整个 users;version=v2 当成一个静态路径段。
手动提取矩阵参数的两种可靠做法
没有自动绑定，就得自己拆。关键点是：必须在中间件或 handler 里从 c.Request().URL.Path 中解析，不能依赖 c.Param()。
- 用
strings.Split()按;切分路径段，再对每个段用=解析键值——适合简单场景，但要注意 URL 编码（%3B或%3D）需先url.PathUnescape() - 更健壮的做法是复用
net/url的逻辑：先用url.ParseRequestURI()解析完整 URL，再对每个路径段调用strings.Cut()提取分号后部分，最后用url.ParseQuery()解析（注意：它接受key=val&key2=val2格式，所以要把;替换为&）
示例片段：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
func parseMatrixParams(path string) map[string]string {
segs := strings.Split(path, "/")
params := make(map[string]string)
for _, seg := range segs {
if i := strings.Index(seg, ";"); i > 0 {
raw := seg[i+1:]
// 将 ; 分隔转为 & 分隔，以便 url.ParseQuery 处理
queryStr := strings.ReplaceAll(raw, ";", "&")
if vals, err := url.ParseQuery(queryStr); err == nil && len(vals) > 0 {
for k, v := range vals {
if len(v) > 0 {
params[k] = v[0]
}
}
}
}
}
return params
}
路由定义时如何兼容矩阵参数语义
别试图在 echo.GET() 的路径字符串里写分号——Echo 的路由器不识别它。正确姿势是：把矩阵参数所在路径段当作普通段处理，靠 handler 自行解析。
- 写成
echo.GET("/users/:id", handler)，而不是"/users;version=:version/:id" - 如果矩阵参数影响资源语义（如版本切换），建议把它提升为一级路径，比如
/v2/users/:id—— 更清晰、可缓存、工具链友好 - 若必须保留矩阵风格（如对接遗留系统），可在中间件统一解析并注入上下文：
c.Set("matrix_params", params)，后续 handler 直接取
注意：矩阵参数无法参与 Echo 的路由树匹配，所以带矩阵参数的请求，其 c.Param("id") 仍能正常工作，但 c.Param("version") 永远为空。
性能与调试容易忽略的坑
每次请求都做字符串切分和 URL 解码，开销虽小但可避免。真正容易翻车的是边界情况：
- 路径中出现未编码的
;（比如用户输入含分号的 ID），会被误判为矩阵参数起始符 - 多个路径段都带矩阵参数（如
/a;b=1/c;d=2），需遍历所有段，不能只看第一个 - 代理或 CDN 可能提前解码或丢弃分号，导致到达 Echo 时已变形
上线前务必用真实网关链路（Nginx / ALB）跑一遍端到端测试，别只在本地 curl 验证。
