shouldbind只解析不校验，故字段缺失、为空或为零值时返回nil却填零值；需显式加binding:"required,min=1"等标签触发校验，且结构体字段须导出并配对json:"name"标签。

ShouldBind 为什么总拿不到错误，却得到零值？

因为 ShouldBind 本身只做解析，不校验——它只在 JSON 格式错误、字段类型不匹配（比如传字符串给 int）时返回 error；而字段缺失、传了空字符串 ""、传了 null 或数值 0，统统放行，结构体字段就填上对应类型的零值。

常见现象：POST {}，c.ShouldBind(&user) 返回 nil，但 user.Name 是 ""、user.Age 是 0。这不是 bug，是设计如此。

• binding:"required" 不生效？大概率是因为没配 json: tag，或字段未导出（小写首字母），或请求字段名和 tag 不一致
• Age *int `binding:"required"` 永远不会触发校验：validator 默认跳过 nil 指针
• 想检查“字段是否出现在请求中”，用 exists；想检查“非空且非零”，得组合 required,min=1（字符串）或 required,gt=0（数值）

required 标签对空字符串无效的三个真实原因

binding:"required" 的语义是“非零值”，不是“非空”。所以 {"name": ""} 过不了 min=1，但能轻松绕过 required。

• 字段没加 json:"name"：反序列化根本不会赋值，校验无从谈起
• 结构体字段小写开头（如 name string）：Go 反射无法访问，绑定失败，校验跳过
• 前端传 user_name，结构体写 json:"username"：字段压根没被填充，required 自然不触发

正确写法示例：Name string `json:"name" binding:"required,min=1,max=20"`

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。

下载

指针字段怎么强制校验存在性？

别用 required，改用 exists。

• Age *int `binding:"exists"`：只要请求 JSON 里没出现 "age" 字段，就报错
• Age *int `binding:"required"`：永远不报错，因为 validator 跳过 nil 指针
• 如果还要校验值范围，拆成两步：Age *int `binding:"exists,gt=0,lt=150"` —— exists 确保字段存在，后面规则才生效

注意：json:",omitempty" 只影响序列化，和绑定/校验完全无关。

ShouldBindJSON 还是 ShouldBind？选哪个更稳？

对外 API 统一用 ShouldBindJSON。它强制走 JSON 解析逻辑，无视 Content-Type 头，避免代理篡改 header 导致静默绑定为空。

• ShouldBind 会根据 Content-Type 自动选解析器：是 application/json 就 JSON，是 application/x-www-form-urlencoded 就 form；但 header 缺失或错误时，它 fallback 到 form 解析，JSON 请求体直接变空
• 混合接口（同时支持 JSON 和表单）才考虑 ShouldBind，但必须严格校验前端发的 header
• 中间件里千万别直接调 ShouldBindJSON：非法 JSON 会 panic；应先 io.ReadAll(c.Request.Body) 预检，再用 c.Request.Body = io.NopCloser(bytes.NewBuffer(bodyBytes)) 重置 body

最易被忽略的一点：自定义验证器必须在 gin.Default() 之后立即注册，且名称大小写敏感；晚一秒或拼错一个字母，就彻底失效。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！