sonic-go JSON解析报错因严格UTF-8校验，不兼容BOM、控制字符或非UTF-8编码；UnmarshalString比Unmarshal快10%~15%但仅在string输入时适用；v1.9.0+需Go1.21+且启用CGO；嵌套结构体字段丢失主因是strict mode跳过未导出字段及tag格式错误。
sonic-go 为什么 JSON 解析还报错 invalid character
sonic-go 不是万能的“JSON 解析加速器”，它默认要求输入是严格合法的 UTF-8 编码 JSON 字符串。一旦源数据含 BOM、控制字符（如 \x00）、或 GBK/GBK2312 混入的乱码字节，sonic.Unmarshal 就会直接 panic 报 invalid character，而标准库 json.Unmarshal 有时反而能容忍部分非法字符（比如跳过零字节）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先用
bytes.HasPrefix(data, []byte{0xEF, 0xBB, 0xBF})检查并剥离 UTF-8 BOM - 用
utf8.Valid(data)验证字节序列是否为合法 UTF-8；不合法时，要么提前转码（如用golang.org/x/text/encoding），要么 fallback 到encoding/json - 避免直接把 HTTP 响应体（尤其是未声明 charset 的旧接口）喂给
sonic.Unmarshal
sonic-go 的 UnmarshalString 和 Unmarshal 性能差多少
UnmarshalString 比 Unmarshal 快约 10%～15%，因为它省掉了从 []byte 到 string 的强制转换开销（Go 中 string 是只读头，转换本身廉价，但 sonic 内部做了零拷贝路径优化）。但这个差距只在高频小 JSON（如微服务间字段级 payload）下明显。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 如果原始数据已经是
string类型（比如从http.Request.FormValue或 RedisGET返回），优先用sonic.UnmarshalString - 如果原始是
[]byte（如io.ReadAll结果），别为了省那点时间额外转成 string——Unmarshal更自然，且避免一次内存分配 - 别为了这点性能在代码里到处做类型判断分支，可读性损失远大于收益
sonic-go 在 Go 1.21+ 下编译失败：找不到 github.com/bytedance/sonic/loader
这是 sonic-go v1.9.0+ 引入的新模块加载机制导致的，它依赖 go:embed 和运行时反射生成代码，对 Go 工具链版本和构建环境敏感。常见于 CGO 禁用、交叉编译、或使用某些精简版 Go 发行版（如 alpine 上的 apk add go）时。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认 Go 版本 ≥ 1.21.0 且非 beta/rc 版本（如
go version输出为go1.21.10才安全） - 确保构建时未设置
CGO_ENABLED=0——sonic-go 的高性能依赖部分 CGO 代码（即使你没显式调用） - 若必须纯静态链接，降级到
v1.8.3（最后一个无 embed 依赖的稳定版），但它不支持time.Time直接解析等新特性
sonic-go 解析嵌套结构体时字段丢失，但 encoding/json 正常
sonic-go 默认启用“strict mode”：它会跳过所有未导出字段（哪怕加了 json:"xxx" tag），且对 struct tag 的拼写、大小写、引号格式更苛刻。典型表现是字段值为零值、或整个嵌套 struct 为 nil。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 检查字段是否首字母小写（即未导出），sonic-go 不会处理它们，哪怕写了 tag —— 这是设计使然，不是 bug
- 确认 tag 中没有全角引号、多余空格或拼写错误，例如
json:"user_id "（末尾空格）会导致字段被忽略 - 若需兼容旧逻辑，可在
sonic.Config中设置DisableStrict，但会损失部分性能和安全性（如忽略未知字段的保护）
