Go Web 参数绑定需手动解析，因net/http不自动绑定；URL参数是扁平字符串，非JSON格式，故json.Unmarshal不可直接使用；正确方式是ParseForm后逐字段赋值或用gorilla/schema映射结构体并配合validator校验。
Go Web 项目里参数绑定不是自动“猜”的，net/http 原生根本不做绑定——你得靠框架或手动解析，否则 r.FormValue 或 r.URL.Query() 拿到的永远是字符串，类型转换和校验全得自己兜底。
为什么 json.Unmarshal 不能直接用在 URL 查询参数上
URL 查询参数（?name=alice&age=25）是扁平 key-value 字符串，没有嵌套结构，也没有类型信息。json.Unmarshal 要求输入是合法 JSON 字节流，直接传 r.URL.Query().Encode() 得到的是 name=alice&age=25，不是 JSON，会报 invalid character 'n' looking for beginning of value。
正确做法是先用 r.ParseForm() 或 r.ParseMultipartForm() 解析，再逐字段赋值或用结构体标签映射：
type UserReq struct {
Name string `form:"name"`
Age int `form:"age"`
}
func handler(w http.ResponseWriter, r *http.Request) {
r.ParseForm()
var req UserReq
if err := r.FormValue("name") != ""; err == nil {
req.Name = r.FormValue("name")
if ageStr := r.FormValue("age"); ageStr != "" {
if age, err := strconv.Atoi(ageStr); err == nil {
req.Age = age
}
}
}
}
gorilla/schema 和 go-playground/validator 配合使用的典型流程
这是中小型项目最稳的组合：前者负责把 url.Values 映射到结构体，后者负责校验。注意它只处理表单（application/x-www-form-urlencoded 和 multipart/form-data），不处理 JSON body。
立即学习“go语言免费学习笔记（深入）”；
-
schema.Decoder默认不递归解嵌套结构体，如Address.City需显式启用decoder.RegisterConverter - 查询参数字段名必须和结构体 tag 中
form值完全一致，大小写敏感 -
time.Time类型需自定义 converter，否则会解成空值 - 切片参数如
?ids=1&ids=2&ids=3能自动转成[]int，但要求 tag 写form:"ids"，不能带[]
JSON 请求体绑定为何常被误认为“自动”，其实依赖 io.ReadCloser 的一次性读取特性
很多人以为 json.NewDecoder(r.Body).Decode(&v) 是“框架自动绑定”，其实只是标准库的惯用法。关键点在于：r.Body 是 io.ReadCloser，一旦读完就 EOF，后续再调 r.FormValue 或 r.ParseForm() 会失败（返回空）。
常见错误：
- 先
DecodeJSON，再想用r.FormValue读 header 或 query —— 拿不到 - 没检查
r.Header.Get("Content-Type")是否为application/json，导致非 JSON 请求 panic - 结构体字段没加
json:tag，导致字段始终零值（Go 默认导出字段才可序列化，但 tag 缺失时解码器无法匹配键名）
安全写法：
if r.Header.Get("Content-Type") != "application/json" {
http.Error(w, "Content-Type must be application/json", http.StatusBadRequest)
return
}
var req UserReq
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
http.Error(w, "Invalid JSON", http.StatusBadRequest)
return
}
自定义绑定函数最容易忽略的边界：空值、零值与未提交字段的语义差异
比如前端没传 status 字段，后端结构体中 Status int 会是 0，但这可能和用户明确传 status=0 含义完全不同。这时不能只靠字段类型判断，得结合 map[string][]string 原始数据看键是否存在。
推荐方案：
- 对必须区分“未提交”和“提交了零值”的字段，用指针类型：
*int，未提交时为nil - 使用
structs.Map或url.Values先提取原始键集，再决定是否覆盖字段 - 避免在绑定层做业务默认值填充（如 status 默认 1），应放在业务逻辑层，否则测试难 mock
参数绑定真正的复杂点不在语法，而在如何让“空”“零”“缺失”“默认”这四种状态在代码里有清晰、不可混淆的表达方式。
