Go json.Unmarshal如何将字符串反序列化到包装atomic.Int32的结构体

zap.AtomicLevel 实现了Go标准库encoding/json提供的json.Unmarshaler自定义反序列化接口，json.Unmarshal运行时不会走默认的结构体反射赋值流程，会直接调用该类型自带的UnmarshalJSON方法完成解析，和其内部包装的atomic.Int32字段没有直接关联。

json包的自定义反序列化规则 #

encoding/json解析值的时候有明确的优先级判断：只要目标类型实现了签名为UnmarshalJSON([]byte) error的方法，就会把当前字段对应的原始JSON字节直接传给这个方法处理，完全跳过默认的“反射遍历结构体、匹配导出字段赋值”的逻辑。

AtomicLevel的实际解析逻辑 #

zap中AtomicLevel的UnmarshalJSON方法逻辑很清晰，简化后的源码如下：

func (a *AtomicLevel) UnmarshalJSON(data []byte) error {
    // 先尝试按字符串格式解析，适配"debug"这类传值
    var s string
    if err := json.Unmarshal(data, &s); err == nil {
        lvl, err := zapcore.ParseLevel(s)
        if err != nil {
            return err
        }
        a.Store(lvl) // 原子写入内部的atomic.Int32
        return nil
    }

    // 字符串解析失败就尝试按数字解析，兼容直接传级别枚举值的场景
    var n zapcore.Level
    if err := json.Unmarshal(data, &n); err != nil {
        return err
    }
    a.Store(n)
    return nil
}

你示例中传入的"level": "debug"，对应到这个方法的入参就是带引号的字节切片"debug"。方法会先把它解析成普通字符串debug，再通过zapcore.ParseLevel匹配到对应的日志级别常量（DebugLevel底层是int32类型的-1），最后通过原子操作把值存入内部的atomic.Int32实例，整个反序列化就完成了。

容易误解的点 #

• AtomicLevel里的l *atomic.Int32是小写开头的未导出字段，默认的json反射逻辑根本没有权限访问这类字段。如果AtomicLevel没实现自定义反序列化接口，反序列化时这个字段会被直接忽略，不可能被正确赋值。
• 除了反序列化，AtomicLevel也实现了json.Marshaler序列化接口，序列化时会把内部存的整型级别转成"debug"/"info"这类可读字符串，不会直接输出数字。
• 底层用atomic.Int32存储的核心目的，是支持运行时并发安全的动态日志级别调整，不用重启服务就能全局修改日志输出等级。

内容的提问来源于stack exchange，提问作者user159566