本文介绍如何在 go 中将任意嵌套结构的 json 解析结果（interface{}）的所有键名统一转为小写，避免因大小写不一致导致 mongodb 查询失败，适用于动态 json 处理场景。
本文介绍如何在 go 中将任意嵌套结构的 json 解析结果（interface{}）的所有键名统一转为小写，避免因大小写不一致导致 mongodb 查询失败，适用于动态 json 处理场景。
在实际微服务或 API 网关开发中，我们常需接收客户端发送的非结构化 JSON 数据，并将其解码为 interface{} 进行后续处理（例如存入 MongoDB）。但客户端字段命名风格不可控——可能混用 userName、USERNAME、username，而 MongoDB 查询对字段名大小写敏感。若直接存储原始结构，后续按 username 查询却存为 UserName，将导致数据丢失或查询为空。
Go 标准库 encoding/json 默认保留原始键名，不提供自动标准化能力。此时，不能依赖 reflect.StructTag（因输入是 map[string]any/[]any，非结构体），而应采用类型断言 + 递归遍历的方式，对所有 map[string]any 类型的键执行 strings.ToLower()，并对嵌套的 slice 和 map 深度处理。
以下是一个生产就绪的通用函数：
import "strings"
func lowerKeys(v any) any {
switch x := v.(type) {
case []any:
// 递归处理切片中的每个元素
result := make([]any, len(x))
for i, item := range x {
result[i] = lowerKeys(item)
}
return result
case map[string]any:
// 创建新 map，键转小写，值递归处理
result := make(map[string]any, len(x))
for key, val := range x {
result[strings.ToLower(key)] = lowerKeys(val)
}
return result
default:
// 基础类型（string, int, bool, nil 等）直接返回
return x
}
}使用方式简洁明确：
var raw any
if err := json.Unmarshal(b, &raw); err != nil {
log.Fatal(err)
}
normalized := lowerKeys(raw) // 所有键名已转为小写
// 此时可安全存入 MongoDB，且后续查询统一用小写字段名✅ 关键优势：
- 完全兼容任意嵌套深度（对象内含数组、数组内含对象等）；
- 零外部依赖，仅需标准库 strings；
- 时间复杂度为 O(N)，其中 N 是 JSON 中键值对总数；
- 不修改原始数据，返回全新结构，线程安全。
⚠️ 注意事项：
- 若原始 JSON 含重复键（如 "Name" 和 "name"），小写后将发生覆盖（后者覆盖前者），建议在业务层增加冲突检测；
- nil、数字、布尔值等基础类型原样透传，无需额外处理；
- 如需转大写，仅需将 strings.ToLower(key) 替换为 strings.ToUpper(key)；
- 若确定 JSON 无嵌套（纯扁平对象），可省略递归逻辑，直接遍历顶层 map[string]any，性能更优。
总结：面对动态 JSON 输入，主动标准化字段名是健壮数据管道的基石。lowerKeys 函数以最小侵入性解决了大小写歧义问题，配合 MongoDB 的灵活 schema，可显著提升系统可靠性与可维护性。
