c.ShouldBind()报required字段缺失，是因为结构体字段缺少form标签或标签值与HTML name不一致，导致Gin无法绑定表单数据，字段保持零值而触发校验失败。
为什么 c.ShouldBind() 报 required 字段缺失？
不是字段真的没传，而是 Gin 没绑定上——最常见原因是结构体字段缺少 form 标签，或标签值与 HTML name 属性不一致。Gin 的 c.ShouldBind() 在 application/x-www-form-urlencoded 或 multipart/form-data 请求下，只认 form 标签，完全忽略 json 或 bson 标签。
例如表单发了 username=alice&email=a@b.com，但结构体写成：
type User struct {
Username string `json:"username" bson:"username"`
Email string `json:"email" bson:"email"`
}
结果 Username 和 Email 全是空字符串，binding:"required" 自然报错。
- 必须为每个需接收的字段显式加
form:"xxx"，且xxx要和 HTML 中<input name="xxx">完全一致 -
form:"-"用于跳过绑定（如ID、时间戳），避免前端伪造或覆盖 - 字段名大小写敏感：HTML 是
user_name，结构体就得写form:"user_name"，不能写成form:"userName"
c.PostForm("key") 返回空字符串的三大硬伤
c.PostForm("key") 看似简单，但失效时往往无声无息。它依赖 Gin 内部 formCache，而这个缓存只在成功调用 ParseMultipartForm 后才填充。一旦失败，后续所有 PostForm 都返回空串。
立即学习“go语言免费学习笔记（深入）”；
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 检查请求头：
Content-Type必须是application/x-www-form-urlencoded或multipart/form-data；若前端发的是 JSON（application/json），PostForm必然为空 -
MaxMultipartMemory设置过小（如默认 32MB），但表单文本字段总大小超限，会导致解析失败，formCache不填充 - body 已被提前读取：中间件里调过
c.GetRawData()、c.Request.Body或其他消耗 body 的操作，PostForm就再也读不到东西
混合场景下如何安全提取表单 + 查询参数 + JSON？
Gin 不支持一次 ShouldBind 同时处理多种数据源。强行混用会丢字段、类型错乱，甚至 panic。
正确做法是拆开处理：
- URL 查询参数（
?page=1&limit=20）用c.Query("page")或c.ShouldBindQuery(&query) - 表单字段（
username=admin）用c.ShouldBind(&form)，结构体带form标签 - JSON payload（
{"extra":{"foo":"bar"}}）用c.ShouldBindJSON(&payload)，结构体带json标签 - 别用
c.PostForm()和c.ShouldBind()对同一请求混用——body 只能读一次，第二次必然失败
字段丢失背后常被忽略的导出规则
即使 form 标签写对了，字段还是空？检查结构体字段是否首字母大写。Go 的反射机制要求字段必须导出（即首字母大写），否则 ShouldBind 根本看不到它，也不会报错，只是静默跳过。
例如：
type User struct {
username string `form:"username"` // ❌ 小写，永远绑定不上
Username string `form:"username"` // ✅ 大写，才能被绑定
}
另外，binding:"required" 只校验导出字段。如果字段未导出，即使有值也不会触发验证，但更大概率是压根没值——因为根本没被绑定进去。
