go 标准库的 `encoding/json` 不支持重复键检测（默认覆盖），但可通过基于事件流的 sax 风格解析器（如 `github.com/garyburd/json`）实时捕获键名、维护作用域栈，在解析过程中精准识别并报错重复键。
在 go 中实现 jsON 重复键检测，核心思路是放弃声明式解码（json.Unmarshal），转而采用流式、事件驱动的解析模型——类似 python 的 Object_hook 或 SAX 解析器，逐个接收语法单元（Token），动态构建解析上下文。标准库 encoding/json 仅提供完整结构化解码，无法干预键冲突逻辑；因此需借助第三方流式 JSON 库，其中 github.com/garyburd/json（现归档，但广泛兼容且原理清晰）是经典选择。
该库以 json.Scanner 为核心，按顺序触发以下关键事件：
- json.Object / json.Array：进入新对象或数组，压入新作用域；
- json.End：退出当前结构，弹出栈顶作用域；
- 其他值类型（如 json.String、json.number）配合 scanner.Name() 获取当前字段名（仅对对象内键有效）。
通过维护一个栈（[]Context），每个 Context 记录当前对象的键集合（map[string]Struct{}），即可在每次读取到新键时快速查重。一旦发现已存在同名键，立即返回带路径信息的错误。
以下是精简可靠的实现示例：
package main import ( "fmt" "github.com/garyburd/json" "io" "strings" ) type context struct { kind json.Kind keys map[string]struct{} } func validateDuplicateKeys(r io.Reader) error { scanner := json.NewScanner(r) var stack []context for scanner.Scan() { switch scanner.Kind() { case json.Object, json.Array: stack = append(stack, context{ kind: scanner.Kind(), keys: make(map[string]struct{}), }) case json.End: if len(stack) == 0 { return fmt.Errorf("mismatched closing token: no open object/array") } stack = stack[:len(stack)-1] default: // 仅在对象内检查键重复（数组无键） if len(stack) > 0 && stack[len(stack)-1].kind == json.Object { key := string(scanner.Name()) if _, exists := stack[len(stack)-1].keys[key]; exists { return fmt.Errorf("duplicate key %q at JSON path %s", key, jsonPath(stack)) } stack[len(stack)-1].keys[key] = struct{}{} } } } return scanner.Err() } // jsonPath 演示如何构建可读路径（如 "root.y.z"），实际中可按需增强 func jsonPath(stack []context) string { // 简化版：返回层级数示意，生产环境建议记录 field name return fmt.Sprintf("level-%d", len(stack)) } func main() { input := strings.NewReader(`{ "a": 1, "b": {"c": 2, "c": 3}, "d": [4,5] }`) if err := validateDuplicateKeys(input); err != nil { fmt.Printf("JSON validation failed: %vn", err) // 输出: duplicate key "c" ... } else { fmt.Println("JSON passed duplicate-key check") } }⚠️ 注意事项与工程建议：
- github.com/garyburd/json 已归档，但代码稳定、无依赖，适合嵌入关键路径；若需活跃维护，可评估 github.com/tidwall/gjson（只读）或 github.com/mohae/deepcopy + 自定义 Unmarshaler 组合方案；
- 对于“保持键序”需求（即 Go 中的有序 map），标准库不支持，但可通过 []map[string]Interface{} 或自定义结构体 + json.RawMessage 延迟解析实现；更推荐使用 github.com/josharian/intern + 切片存储 (key, value) 对；
- 本方案具备线性时间复杂度 O(n)，内存开销仅取决于最大嵌套深度，适用于高吞吐、强校验场景（如 API 网关、配置中心）；
- 错误信息应补充具体行号/偏移量：scanner.Pos().Offset 可获取字节位置，便于调试。
综上，Go 中实现 JSON 重复键检测并非“不可为”，而是需切换思维——从“解码数据”转向“解析过程”，利用流式解析器的事件能力，在语法树构建途中主动拦截违规行为。这既是 Go 类型安全哲学的延伸，也是构建健壮数据管道的关键一环。