Gin默认不转换JSON键大小写，因其严格按结构体json标签精确匹配，不预处理键名；需显式声明如json:"user_id"才能映射小写/下划线键到大驼峰字段。
为什么Gin默认不把JSON键转成大写？
Gin的c.BindJSON()直接按结构体字段名（或json标签）映射，不会修改原始JSON键的大小写。如果你收到{"name": "alice"}，而结构体字段是Name且带json:"NAME"标签，Gin也不会自动把"name"变成"NAME"再匹配——它只做“键到标签”的精确匹配，不干预输入键本身。
换句话说：Gin不重写请求体，也不预处理键名。想让{"user_id": 123}映射到UserID字段，得靠结构体定义，而不是靠框架帮你“统一转大写”。
如何让小写/下划线键映射到大驼峰字段？
用结构体字段的json标签显式声明对应关系，这是最轻量、最可控的做法。Gin会按标签名去匹配JSON键，不管原始键是小写还是下划线。
-
type User struct { Name string `json:"name"` }→ 接收{"name": "x"} -
type User struct { UserID int `json:"user_id"` }→ 接收{"user_id": 123} -
type User struct { CreatedAt time.Time `json:"created_at"` }→ 接收{"created_at": "2024-01-01T00:00:00Z"}
注意：json标签值区分大小写，json:"USER_ID"只会匹配{"USER_ID": ...}，不会匹配{"user_id"}或{"UserID"}。
立即学习“go语言免费学习笔记（深入）”；
能不能在Bind前统一把JSON键转成大写？
可以，但不推荐。你需要读取原始body、解析为map[string]interface{}、遍历键并转大写（如strings.ToUpper(key)）、再序列化回字节流，最后交给BindJSON。这会破坏Gin的流式解析、增加内存拷贝、绕过标准验证流程。
更现实的问题是：JSON键转大写后语义可能错乱。比如{"api_key"}→"API_KEY"没问题，但{"http_status"}→"HTTP_STATUS"和"HTTPSTATUS"边界模糊；还有嵌套对象、数组里对象的键，递归处理容易漏。
如果真要预处理，建议只做一次转换并在中间件里完成：
func UppercaseJSONKeys() gin.HandlerFunc {
return func(c *gin.Context) {
body, _ := io.ReadAll(c.Request.Body)
var raw map[string]interface{}
json.Unmarshal(body, &raw)
upperMap := make(map[string]interface{})
for k, v := range raw {
upperMap[strings.ToUpper(k)] = v
}
newBody, _ := json.Marshal(upperMap)
c.Request.Body = io.NopCloser(bytes.NewBuffer(newBody))
c.Next()
}
}
但请确认下游结构体字段名全是全大写（如NAME、USERID），否则仍无法绑定。
接收任意键名时怎么灵活处理？
如果前端传的键名完全不可控（比如不同版本混用user_id/userId/USER_ID），别硬靠结构体绑定。改用c.ShouldBindBodyWith(&raw, binding.JSON)先拿到原始map[string]interface{}，再手动提取、转换、校验：
var raw map[string]interface{}
if err := c.ShouldBindBodyWith(&raw, binding.JSON); err != nil {
c.AbortWithStatusJSON(400, gin.H{"error": "invalid JSON"})
return
}
name := getStringFromKeys(raw, "name", "NAME", "Name", "user_name")
id := getIntFromKeys(raw, "id", "ID", "user_id", "USER_ID")
其中getStringFromKeys是自定义函数，按优先级尝试多个键名。这种方式牺牲了类型安全和自动校验，但换来对混乱输入的实际容忍度。
真正麻烦的不是转大写，而是“大写之后怎么跟Go字段对齐”——Go没有运行时反射修改结构体标签的能力，所有映射关系必须在编译期确定。所以别指望框架替你猜，老老实实写好json标签，或者在业务层做兜底解析。
