Gin框架自定义路由匹配规则与参数获取-Golang-PHP中文网

gin中:param无法匹配.html后缀，因它只捕获单段无斜杠路径；应优先用noroute兜底处理后缀，而非硬套参数语法或一级通配符。

gin框架自定义路由匹配规则与参数获取

Gin 默认的路由匹配足够用，但遇到 .html 后缀、多级嵌套路由、或需要统一拦截某类路径时，就得绕开 GET/POST 快捷方法，改用更底层的机制。直接上结论：优先用 NoRoute 或 Handle，别硬套 :param 去匹配后缀或模糊路径。

为什么 `:userid` 不能匹配 `/user/123.html`

Gin 的路径参数（如 :userid）只匹配「非斜杠」连续段，且不关心文件扩展名。写成 /user/:userid.html 是无效语法，Gin 会把它当静态路径字面量处理，根本不会提取参数。

/user/:id 只能匹配 /user/123、/user/abc，但不匹配 /user/123.html
/user/:id.html 实际注册的是字面路径 /user/:id.html，不是动态参数 —— 浏览器访问它，c.Param("id") 返回空字符串
想支持 .html 后缀，必须用通配或兜底逻辑，而不是改参数写法

`NoRoute` 比 `Handle("GET", "/*.html", ...)` 更可靠

NoRoute 是 Gin 提供的未命中路由兜底机制，比通配符 /*.html 更灵活、更安全，尤其适合处理带层级的后缀路径（比如 /blog/post-123.html 或 /docs/v2/api.html）。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

r.Handle("GET", "/*.html", ...) 只能匹配一级路径，/a/b.html 不会触发
NoRoute 拿到的是原始 c.Request.URL.Path，可自由做 strings.HasSuffix、strings.TrimSuffix、正则匹配等

示例：

r.NoRoute(func(c *gin.Context) {
    path := c.Request.URL.Path
    if strings.HasSuffix(path, ".html") {
        filename := strings.TrimSuffix(path, ".html")
        c.String(200, "Serving %s", filename)
        return
    }
    c.AbortWithStatusJSON(404, gin.H{"error": "not found"})
})

`c.Param("action")` 和 `*action` 的区别必须分清

路径中用 *action 是 Gin 的“通配符参数”，和 :param 完全不同：前者捕获从该位置开始的**全部剩余路径**（含斜杠），后者只捕获单段。

/user/:name/*action → 访问 /user/john/tools/edit 时：
c.Param("name") == "john"，
c.Param("action") == "/tools/edit"（注意开头有斜杠）
若想取干净路径，得手动处理：strings.TrimPrefix(c.Param("action"), "/")
多个 * 通配符不被支持 —— /a/*x/b/*y 是非法路由定义，Gin 启动时 panic
通配符必须放在路径末尾，不能中间穿插，否则注册失败

参数提取失败时，`c.Param` 返回空字符串而非报错

这是最容易踩的坑：Gin 不会在参数缺失时主动中断或抛异常，c.Param("id") 在没匹配到时返回空字符串 ""，业务逻辑若没校验就直接用，可能引发空指针或 SQL 注入风险。

永远对关键参数做非空判断：if userid := c.Param("userid"); userid == "" { c.AbortWithStatusJSON(400, gin.H{"error": "userid required"}) }
c.DefaultQuery 和 c.DefaultPostForm 有默认值兜底，但 c.Param 没有 —— 它只负责“取”，不负责“验”
如果路由定义为 /user/:id，而请求是 /user/（结尾带斜杠），c.Param("id") 仍为空，因为 :id 没捕获到任何内容