Go-Zero通过httpx.Parse自动绑定HTTP参数到结构体字段，按path→query→header→form→json body优先级覆盖；字段名须小驼峰，tag必须准确（path/form/header/json），类型需匹配，否则静默失败或400错误。
在 Go-Zero 中，HTTP 请求参数必须自动绑定到结构体字段，否则 handler 里拿不到值——这不是靠手写解析实现的，而是由 httpx.Parse 根据结构体 tag 和请求上下文自动完成的。你写的结构体字段名、大小写、tag 写错一个，参数就直接丢失，连日志都看不到原始值。
请求参数绑定的核心机制
Go-Zero 不要求你在 handler 里手动调用 r.URL.Query() 或 json.Decoder。它通过 httpx.Parse(r, &req) 一次性从 path、query、header、form、json body 四个来源按优先级提取并填充字段。顺序固定为：path → query → header → form → json body，后读取的会覆盖先读取的同名字段。
这一步不报错也不提示缺失——如果某个字段没匹配上任何来源，就保持零值（0、""、nil），而你的业务逻辑若没做空值判断，就会静默出错。
path 参数：URL 路径里的变量必须用 path tag
方法一：定义结构体时显式标注 path tag
在 types/types.go 或 handler 同目录下定义请求结构体，字段必须小驼峰命名，且带 path tag：
type GetUserRequest struct {<br> Id int64 `path:"id"`<br>}
对应路由必须是 GET /user/:id，且 URL 中的 :id 必须与 tag 值完全一致；【Id 字段类型必须能接收字符串转整数，否则解析失败直接返回 400】。
方法二：用 goctl 自动生成（推荐）
在 xxx.api 文件中声明路径变量：get /user/:id → goctl 生成的结构体自动带 path:"id" tag，无需手写。
query 参数：URL 查询串默认按字段名匹配，也可用 form tag 显式控制
第一步：定义结构体字段，不加 tag 时默认按字段名小写匹配 query key
例如请求是 GET /user?name=jack&page=2，结构体写成：
type ListUserRequest struct {<br> Name string<br> Page int<br>}
Go-Zero 会自动把 name=jack 绑定到 Name 字段，page=2 绑定到 Page 字段。
第二步：当 query key 名与字段名不一致时，必须加 form tag
比如前端传的是 ?user_name=jack，但你不想改结构体字段名为 UserName（违反小驼峰规范），那就加 tag：UserName string `form:"user_name"`。注意：【不能用 json tag 替代 form，否则 query 参数无法绑定】。
第三步：布尔值和数组要特别处理
query 传 ?active=true&tags=a,b,c，结构体需写为：Active bool `form:"active"` 和 Tags []string `form:"tags,comma"`。其中 ,comma 是 go-zero 特有语法，表示用逗号分割字符串为切片；不加这个后缀，Tags 只会收到第一个值 "a"。
JSON Body 参数：必须用 json tag，且结构体字段名必须小驼峰
① 定义结构体时，所有字段必须用小驼峰命名，并配 json tag：
type CreateUserRequest struct {<br> UserId int64 `json:"user_id"` // ❌ 错误！go-zero 不识别下划线命名的 json tag<br> UserName string `json:"user_name"` // ❌ 同样错误<br> UserId int64 `json:"userId"` // ✅ 正确<br> UserName string `json:"userName"` // ✅ 正确<br>}
② handler 中调用 httpx.ParseJsonBody(r, &req) 或更通用的 httpx.Parse(r, &req) ——后者会自动识别 Content-Type 并选择解析方式。
③ 如果 JSON 字段是可选的，加 json:",optional"；如果希望零值不参与序列化（如 0、"" 不发给下游），加 json:",omitempty"。但注意：【validate 校验仍会对零值生效，optional 不等于跳过校验】。
Header 和 Form 参数：分别用 header 和 form tag
Header 示例：需要读取 X-Trace-ID，结构体字段写为：TraceId string `header:"X-Trace-ID"`。注意 header 名大小写不敏感，但 tag 值建议按标准写法大写首字母。
Form 示例：POST 表单提交 application/x-www-form-urlencoded，字段名是 email，结构体字段写为：Email string `form:"email"`。如果表单字段名含点号或中划线（如 user.email），go-zero 默认不支持，必须改造成下划线或小驼峰形式再映射。
