答案：Golang中JSON校验常用结构体标签与json.Unmarshal基础类型检查，结合validator.v10库实现字段级验证。通过定义validate标签可校验必填、格式、范围等规则，支持自定义函数扩展，如oneof或notadmin；实战建议先解析再验证，导出字段并统一入口处理。
在Golang中实现JSON格式校验，常见方式是结合结构体标签（struct tags）与 encoding/json 包进行反序列化，再配合第三方库或自定义逻辑完成字段级验证。下面通过实际项目场景，介绍几种简单有效的JSON校验方法。
使用结构体标签 + json.Unmarshal 基础校验
Go原生的 json.Unmarshal 能自动校验JSON是否符合目标结构体的字段类型。若类型不匹配或必填字段缺失（且无omitempty），会返回错误。
示例：定义用户注册请求结构体
type UserRequest struct {
Name string `json:"name"`
Email string `json:"email"`
Age int `json:"age"`
IsActive bool `json:"is_active"`
}
当传入的JSON中 age 是字符串而非数字时，Unmarshal 会直接报错：
var req UserRequest
err := json.Unmarshal([]byte(jsonStr), &req)
if err != nil {
log.Fatal("JSON格式错误:", err)
}
这种方式适合基础类型校验，但无法处理“字段非空”、“邮箱格式”等业务规则。
立即学习“go语言免费学习笔记（深入）”；
集成 validator.v9 实现字段级校验
更实用的做法是使用 github.com/go-playground/validator/v10 库，支持丰富的验证标签。
步骤一：安装依赖
go get github.com/go-playground/validator/v10步骤二：为结构体添加 validate 标签
import "github.com/go-playground/validator/v10"
type UserRequest struct {
Name string `json:"name" validate:"required,min=2,max=50"`
Email string `json:"email" validate:"required,email"`
Age int `json:"age" validate:"gte=0,lte=150"`
IsActive bool `json:"is_active"`
}
步骤三：反序列化后执行校验
var req UserRequest
if err := json.Unmarshal([]byte(jsonStr), &req); err != nil {
log.Fatal("JSON解析失败:", err)
}
validate := validator.New()
if err := validate.Struct(req); err != nil {
for _, e := range err.(validator.ValidationErrors) {
log.Printf("字段 %s 错误: %s", e.Field(), e.Tag())
}
return
}
这样就能捕获如“Name不能为空”、“Email格式不正确”等问题。
自定义验证函数扩展规则
如果内置规则不够用，比如需要校验某个字段是否在允许列表中，可以注册自定义验证器。
例如：限制用户角色只能是 admin 或 user
type UserRequest struct {
Name string `json:"name" validate:"required"`
Role string `json:"role" validate:"oneof=admin user"`
}
或者注册函数实现更复杂逻辑：
validate.RegisterValidation("notadmin", func(fl validator.FieldLevel) bool {
return fl.Field().String() != "admin"
})
然后使用：Role string validate:"notadmin"
实战建议与常见问题
在真实项目中，注意以下几点：
- 始终先做 json.Unmarshal，确保JSON语法合法
- 结构体字段必须是导出的（大写开头），否则json包无法赋值
- 对于可选字段，使用 omitempty 并配合 omitempty 验证逻辑
- 嵌套结构体也会被 validator 自动递归校验
- API入口处统一做校验，避免重复代码
基本上就这些。简单场景用结构体+Unmarshal，复杂业务推荐 validator 库，灵活又高效。
