Echo框架参数绑定需分层处理：路径参数用c.Param()、查询参数用c.QueryParam()、表单用c.FormValue()/c.FormFile()、JSON体用c.Bind()，且struct标签须显式声明param:"id"或query:"name"等，否则无法绑定；绑定顺序为path→query→body，后覆盖前。
Echo 框架上传参数不能靠 c.Bind() 一次性收全，必须按来源分层处理：路径、查询、表单字段、文件、JSON 体各自有对应方法，混用或漏调就会丢数据。
路径参数和查询参数要用 c.Param() 和 c.QueryParam()
路径参数（如 /users/:id）和查询参数（如 ?name=john&page=2）不会进 c.Bind()，必须显式提取：
-
c.Param("id")获取路由中定义的命名参数，注意名字要和:id一致 -
c.QueryParam("name")读单个查询参数；c.QueryParams()返回url.Values全量 map - struct 绑定时，字段标签必须带
param:"id"或query:"name"才能被c.Bind()识别，仅靠变量名无效 - 如果同时有
/users/123?name=old和 body{"name":"new"}，c.Bind()最终取的是 body 的值——因为绑定顺序是 path → query → body，后覆盖前
c.FormValue() 和 c.FormFile() 处理 multipart 表单
当 Content-Type 是 multipart/form-data，且前端表单写了 enctype="multipart/form-data"，才能用这两个方法：
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
-
c.FormValue("title")读普通文本字段（非文件），大小写必须和前端字段名完全一致 -
file, err := c.FormFile("avatar")获取文件头，file.Filename不可信，需校验防止路径遍历 - 必须先调
c.Request().ParseMultipartForm(32 << 20)（或让 Echo 自动调），否则c.FormFile()返回nil或 panic “Part already parsed” -
ParseMultipartForm的参数不是最大上传体积，而是“非文件字段内存缓存上限”，文件本身走临时磁盘，不受此值限制
JSON 数组不能用 c.Bind()，得手动 json.NewDecoder()
c.Bind() 只支持 struct 类型，传 []User 或 map[string]string 会报 binding element must be a struct：
- 正确做法：
var users []User; err := json.NewDecoder(c.Request().Body).Decode(&users) - body 只能读一次，调完
Decode()后不能再用c.Bind()或重复读c.Request().Body - 若要兼容单对象
{"name":"a"}和数组[{"name":"a"},{"name":"b"}]，需先io.ReadAll()Peek 内容，看首字符是{还是[，再分支解析 - 记得在 handler 开头加
defer c.Request().Body.Close()，否则连接可能泄漏
Header 和 Cookie 参数需单独取，c.Bind() 默认不处理
Header（如 X-Request-ID）、Cookie、JWT claim 等都不参与默认绑定流程：
-
c.Request().Header.Get("X-Tenant-ID")直接取 header 值，空值需自行校验 -
c.Cookie("session_id")获取 cookie，返回*http.Cookie或 error - JWT 中的字段（如
tenant_id）需在鉴权中间件后从c.Get("user_claims")提取，不能指望c.Bind()自动注入 - 想让 header 数据进 struct，得自定义 binder 或手动赋值——
c.Bind()默认只认param/query/form/json标签
最容易被忽略的是：所有这些参数来源互不干扰，也没有自动合并逻辑。你得明确知道前端把数据放哪儿了，再选对方法去拿；少一步，参数就静默丢失，而错误日志里往往只显示 “field is empty”，不提示来源缺失。
