Golang 小技巧：使用 DisallowUnknownFields 检查未知 JSON 字段

在 Go 中，使用 json.Unmarshal 解析 JSON 时，多余的字段默认会被忽略。

例如：

type User struct {
	Name string `json:"name"`
}

data := []byte(`{
	"name": "Tom",
	"age": 18
}`)

var user User

err := json.Unmarshal(data, &user)
fmt.Println(err) // nil

虽然 User 中并没有 age 字段，但解析仍然可以成功。

如果希望接口参数更加严格，可以使用：

decoder := json.NewDecoder(r.Body)
decoder.DisallowUnknownFields()

例如：

var user User

decoder := json.NewDecoder(r.Body)
decoder.DisallowUnknownFields()

if err := decoder.Decode(&user); err != nil {
	return err
}

这时候如果请求中出现结构体没有定义的字段，就会直接返回错误。

小结

对于需要严格校验 JSON 参数的接口，可以使用：

decoder.DisallowUnknownFields()

这样可以更早发现字段拼写错误或者客户端传入了不支持的参数，在配置解析和 API 请求校验中都很实用。