Go httprouter中/hello/:name与/hello/b/c路由冲突panic如何处理？

httprouter的路由基于**基数树（Radix Tree）**实现，冲突校验规则为：同一父节点下不允许同时存在固定路径子节点和通配符（:开头的参数、*开头的 catch-all）子节点，和路径的总长度无关。
你注册/hello/b/c时，会先在/hello/节点下生成固定子节点b，后续再注册/hello/:name时，/hello/节点下要新增通配符子节点:name，和已有的b节点属于同一层级，直接触发冲突校验，因此会触发panic，和两个路由的层级数无关。

报错原文：httprouter :panic: wildcard route ':name' conflicts with existing children in path '/hello/:name'.

方案1：调整路由结构，避免同层级冲突 #

这是最推荐的方案，符合httprouter的设计规范，只需要修改其中一个路由的前缀，避开同一父节点下同时存在固定和通配符节点即可，比如：

• 将参数路由修改为/hello/user/:name，和固定路径/hello/b/c完全区分开
• 或者将固定路径修改为/hello/static/b/c，避开和通配符同层级
  修改后路由注册逻辑不会再触发冲突，性能也没有任何损失。

方案2：在通配符Handler中做逻辑分流 #

如果你必须保留原有的路由结构，可以只注册更高优先级的通配符路由，在Handler内部手动判断路径，走对应的处理逻辑：
你可以注册/hello/*path的 catch-all 路由，然后手动拆分路径判断：

package main

import (
    "fmt"
    "log"
    "net/http"
    "strings"

    "github.com/julienschmidt/httprouter"
)

func Index(w http.ResponseWriter, r *http.Request, ps httprouter.Params) {
    path := strings.Trim(ps.ByName("path"), "/")
    parts := strings.Split(path, "/")
    // 判断是否匹配/hello/b/c的场景
    if len(parts) == 2 && parts[0] == "b" && parts[1] == "c" {
        Index2(w, r, ps)
        return
    }
    // 原来的/hello/:name逻辑，判断是两级路径
    if len(parts) == 1 {
        name := parts[0]
        fmt.Fprintf(w, "Welcome %s!\n", name)
        return
    }
    // 其他情况返回404
    http.NotFound(w, r)
}

func Index2(w http.ResponseWriter, r *http.Request, _ httprouter.Params) {
    fmt.Fprint(w, "Welcome222!\n")
}

func main() {
    router := httprouter.New()
    // 只注册catch-all路由，内部做逻辑分发
    router.GET("/hello/*path", Index)

    log.Fatal(http.ListenAndServe(":8080", router))
}

方案3：替换为支持同层级混合匹配的路由库 #

如果不想改现有路由结构也不想加分流逻辑，可以换用对路由冲突规则做了优化的框架，比如gin的路由组件就是基于httprouter二次开发的，支持同层级固定路径优先级高于通配符路径，不会触发此类冲突：

// 基于gin的示例代码，两个路由可以共存
package main

import (
    "net/http"
    "github.com/gin-gonic/gin"
)

func main() {
    r := gin.Default()
    r.GET("/hello/b/c", func(c *gin.Context) {
        c.String(http.StatusOK, "Welcome222!")
    })
    r.GET("/hello/:name", func(c *gin.Context) {
        name := c.Param("name")
        c.String(http.StatusOK, "Welcome %s!", name)
    })
    r.Run(":8080")
}

内容的提问来源于stack exchange，提问作者桃桃桃子