Go encoding/json/v2 怎么禁止对象里的重复成员名

Go 的 encoding/json/v2 已经把这件事设成默认规则：解码 JSON 对象时，只要出现重复成员名，就返回错误，不需要再额外打开“禁止重复”的开关。真正需要检查的是，代码有没有误传 jsontext.AllowDuplicateNames(true)，以及迁移过程中是否把 foo、Foo 这类大小写变体当成同一字段。

先确认 v2 的默认拒绝边界

JSON 标准没有规定对象成员名重复时必须保留哪一个值。不同实现可能覆盖、合并或报错，这会让鉴权层和业务层对同一份请求得出不同结论。encoding/json/v2 选择了更严格的默认值：重复名直接失败；只有明确允许时，后出现的成员才可能参与覆盖或合并。

最小解码入口可以保持很简单：

package main

import (
    "fmt"
    "encoding/json/v2"
)

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

func main() {
    // 两个 name 会触发 v2 的重复成员名错误。
    input := []byte(`{"name":"alice","name":"bob"}`)
    var req Request
    if err := json.Unmarshal(input, &req); err != nil {
        // 边界层保留错误，不把后出现的值当成可信结果。
        fmt.Printf("拒绝输入: %v\n", err)
        return
    }
    fmt.Printf("合法请求: %+v\n", req)
}

这里的关键不是自定义去重器，而是不要在入口处吞掉 error。如果请求来自 HTTP、消息队列或文件导入，解码失败就应当沿着原有错误链返回 4xx、丢弃消息或进入人工处理，而不是继续使用半填充的结构体。

不要误开 AllowDuplicateNames

迁移时最容易出现的“修复”是为了兼容旧数据，统一给所有调用追加 jsontext.AllowDuplicateNames(true)。这个选项不是“更宽松但仍然安全”的兼容开关，而是明确允许存在歧义输入。允许后，成员按出现顺序处理，后面的值可能覆盖前面的值；不同下游若有不同处理方式，仍可能产生请求语义不一致。

因此建议把选项分层：普通 API 请求不传该选项；只有确实要读取保留成员顺序的特殊格式时，才在局部调用点显式记录原因，并配套输入来源、格式版本和测试样例。不要把它塞进全局公共函数，让所有业务悄悄继承放宽策略。

大小写变体要单独做兼容判断

默认情况下，v2 对 Go 结构体字段使用严格大小写匹配，所以 name 和 Name 不会仅凭大小写就变成同名成员。若业务开启了 json.MatchCaseInsensitiveNames(true)，或者在字段标签中使用 case:ignore，大小写变体可能匹配到同一个字段，并参与重复名判断。

这意味着“禁止重复”不等于只测试 {"name":1,"name":2}。迁移测试至少应覆盖精确重复、大小写变体、未知成员和嵌套对象四组输入。若接口契约要求固定大小写，保持严格匹配更容易发现客户端错误；若必须兼容多种命名风格，应明确哪些变体被视为同一字段。

把错误处理和 v1 迁移放进清单

encoding/json/v2 的语义错误会携带更具体的上下文，业务层不必依赖错误字符串来判断是否重复。可以先统一记录错误，再按接口协议转换为对外响应：

func decodeRequest(data []byte) (Request, error) {
    // 先让 v2 执行默认的重复成员名检查。
    var req Request
    if err := json.Unmarshal(data, &req); err != nil {
        // 不返回部分成功对象，调用方只能拿到明确的失败结果。
        return Request{}, fmt.Errorf("decode request: %w", err)
    }
    return req, nil
}

上线前用同一组样例分别跑旧包和 v2：确认旧系统依赖“最后一个值”的地方已经改成拒绝或显式清洗；确认公共封装没有默认追加 AllowDuplicateNames(true)；确认日志不会把完整敏感请求体直接写出。若只是为了兼容历史脏数据，优先在导入专用边界做一次性清洗，再让核心服务保持严格默认。

常见问题

只调用 encoding/json/v2.Unmarshal 就够了吗？

对重复成员名这一条够用，v2 默认会拒绝。还要检查调用链是否传入了放宽选项，以及自定义解码器是否自行改变了语义。

AllowDuplicateNames(true) 能解决旧接口兼容吗？

它只能允许输入继续进入解析流程，不能解决上下游对重复值的不同解释。应限制在确有格式要求的局部入口，并补充回归测试。

foo 和 Foo 算重复吗？

严格匹配下不一定；开启大小写不敏感匹配后，它们可能命中同一字段并触发重复判断，需按接口契约选择策略。