应优先使用c.QueryParam("key")或c.QueryParams()取Query参数，避免直接调用c.Request().URL.Query()，因其绕过Echo解码逻辑、不处理编码和代理兼容性问题。
直接用 c.QueryParam("key") 或 c.QueryParams()，别碰 c.Request().URL.Query() 以外的解析方式——它不处理编码、不合并重复键、也不兼容某些代理转发场景。
Query 参数该用哪个方法取？
Echo 的 echo.Context 提供了两层封装：轻量级单值获取和批量结构化读取。
-
c.QueryParam("name")返回第一个匹配值（string），空时返回空字符串，适合简单字段 -
c.QueryParams()返回url.Values（本质是map[string][]string），能拿到所有同名参数，比如?tag=a&tag=b→["a", "b"] - 别用
c.Request().URL.Query()：它绕过 Echo 内部的 URL 解码逻辑，遇到%20、+、中文等会出错；且在反向代理（如 Nginx）透传原始 query string 失败时，结果不可靠
Query 绑定到 struct 怎么写标签？
用 query 标签配合 c.Bind()，但注意：只有显式声明了 query 的字段才会被填充，且只从 URL 查询串读，不混入 path 或 body。
- 结构体字段必须导出（首字母大写）
- 标签写法：
Name string `query:"name"`，支持别名、必填（query:"name,required"）、默认值（query:"name,default=guest"） - 绑定调用：
err := c.Bind(&u)—— 这会同时尝试 path、query、body，但 query 优先级低于 path，高于 body；若你只想绑 query，建议手动用c.QueryParams()+schema库或自定义映射
常见错误：Query 值为空或乱码
不是框架问题，基本是客户端或中间层没按规范发请求。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 前端用
fetch或axios时忘了URLSearchParams编码，直接拼字符串导致空格/中文变%20但未解码 → 后端看到的是原始编码串 - Nginx 配置里用了
proxy_pass但没加尾部/，导致 query string 被截断（例如proxy_pass http://backend;会丢掉?q=xxx） - 测试用
curl "http://localhost:8080/?q=hello world"没加引号，shell 把空格当分隔符 → 实际只传了q=hello
Query 和 Path Param 混用时怎么避免冲突？
Echo 的 Bind() 默认按顺序覆盖：path → query → body。如果你的结构体字段同时带 param 和 query 标签，且两者 key 相同，query 值会覆盖 path 值。
- 例如路由
/user/:id?q=id+ 结构体ID int `param:"id" query:"id"`，最终ID取的是 query 中的id，不是 path 的 - 想强制用 path 值？去掉
query标签，或改用c.Param("id")单独取 - 想让 query 优先但又不污染 path 字段？给 query 字段起不同 tag 名，比如
query:"filter_id"
真正难的不是取值，而是确认 query 到底有没有进得来——先抓包看 req.URL.RawQuery，再比对 c.QueryParams() 输出，差在哪，问题就在哪。
