Go json.Marshal抛出reflect: call of reflect.Value.Int on zero Value异常

问题根因 #

你遇到的panic是反射操作零值对象触发的，你猜测的竞态条件确实是该问题的典型触发原因。

Go标准库的encoding/json序列化基于反射实现，序列化过程中会递归读取结构体每个字段的类型和值：如果有多个goroutine同时读写同一块结构体内存，写操作更新字段（尤其是指针类型、interface类型、嵌套map的value值）的过程中，序列化协程可能读到“半更新”的异常状态——比如某个本应为int类型的字段/值被中途置空、或者类型被临时修改，反射层拿到了不匹配的zero Value，调用Int()方法时就会触发该panic。
从你提供的堆栈信息可以看到，panic发生在mapEncoder调用intEncoder的流程中，说明问题大概率出在你结构体嵌套的map字段的读写冲突上。

排查与解决方案 #

• 优先使用Go自带的竞态检测工具定位问题：线下压测时给编译/运行命令加-race参数，复现后会直接输出数据竞争的具体代码位置，效率远高于人工排查。
• 临时兜底方案：在MarshalBinary方法外层加defer recover逻辑，仅捕获该类反射panic，避免进程直接崩溃，注意不要无差别吞掉所有panic。
• 根治方案：
  1. 给userCore结构体的所有读写操作加互斥锁sync.Mutex，确保序列化和更新操作互斥执行
  2. 也可以在序列化前先深拷贝一份userCore的副本，用副本执行序列化操作，避免直接操作共享内存
• 额外注意：如果你的结构体里包含interface{}类型字段、或者value类型为interface的map，不要在写操作中随意变更同一个key的value类型，类型不匹配也会触发同类反射panic。

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