Echo框架Context读取路径参数的详细教程-Golang-PHP中文网

c.Param() 是唯一推荐的路径参数读取方式，因其直接对接路由匹配结果，而 QueryParam、FormValue 等方法分别处理查询参数和表单字段，无法获取路径参数；可选参数 :id? 未提供时返回空字符串，需用 == "" 判断；结构体绑定路径参数必须使用 param:"id" 标签。

echo框架context读取路径参数的详细教程

c.Param() 是唯一推荐的路径参数读取方式，其他方法如手动解析 c.Request().URL.Path 会绕过 Echo 的路由匹配逻辑，导致参数名不一致、空值处理异常或与中间件行为冲突。

为什么不能用 QueryParam 或 FormValue 读路径参数

路径参数（如 /user/:id 中的 id）和查询参数（?name=foo）、表单字段是完全独立的数据源。Echo 的 c.QueryParam("id") 永远不会返回路径中匹配到的 id 值，哪怕 URL 是 /user/123?id=456 —— 它只查问号后的键值对。

c.Param("id") 返回 "123"
c.QueryParam("id") 返回 "456"
混用时若未加区分，极易在日志、权限校验或数据库查询中传错 ID

带可选路径参数（`:id?`）的边界情况

当路由定义为 e.GET("/user/:id?", handler)，c.Param("id") 在未提供该段时返回空字符串 ""，不是 nil 或报错。必须显式判断：

Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载

id := c.Param("id")
if id == "" {
    id = "default"
}

不要用 if id != nil —— string 类型不可能为 nil
不要依赖 len(id) == 0 以外的空值判断，因为 Param 不会 panic，也不会返回占位符
若需强制存在，应改用必填参数 :id 并由路由层拦截缺失请求

结构体绑定路径参数：param 标签必须显式声明

直接调用 c.Bind() 不会自动填充路径参数，必须配合结构体字段的 param tag：

type UserReq struct {
    ID string `param:"id"`
}
func handler(c echo.Context) error {
    req := new(UserReq)
    if err := c.Bind(req); err != nil {
        return err
    }
    // 此时 req.ID 已被设为 c.Param("id")
}