Go json.RawMessage 复制后为什么数据会跟着变

如果把 json.RawMessage 直接赋值给另一个变量，复制的只是切片的指针、长度和容量，底层字节数组没有自动复制。因此，后续通过索引修改，或者让 UnmarshalJSON 复用这块容量写入新数据，另一份值也可能跟着变化。要获得真正独立的 JSON 原文，应显式使用 bytes.Clone 或复制到 nil 切片。

判断标准很简单：只要两份 RawMessage 共享底层数组，它们就不是独立快照；跨 goroutine、缓存或异步处理传递前，先做一次深拷贝。

先看清 RawMessage 复制的是哪一层

Go 官方把 RawMessage 定义为原始编码的 JSON 值，底层是字节切片。切片变量本身很小，赋值只会复制切片描述，不会复制它指向的数组。下面的示例没有修改 JSON 结构，只改了共享数组中的一个字节：

package main

import (
    "fmt"
    "encoding/json"
)

func main() {
    raw := json.RawMessage(`{"name":"old"}`)
    alias := raw // 只复制切片描述，alias 与 raw 共享底层数组
    alias[10] = 'X' // 直接改共享字节，两个切片都能观察到变化
    fmt.Println(string(raw)) // 输出：{"name":"oXd"}
}

这里的关键不是 json 包做了特殊缓存，而是 RawMessage 没有脱离切片的内存模型。把变量放进结构体、从函数返回，或用 raw[:len(raw)] 重切，都不能自动消除这个别名。

为什么 Unmarshal 后另一份数据也变了

json.Unmarshal 调用 RawMessage.UnmarshalJSON 时，会把输入数据复制到接收者。官方实现使用接收者原有切片的零长度视图再执行 append，这样可以在容量足够时复用原数组。这对单独的变量没有问题，但两个 RawMessage 若共享数组，写入左值就会覆盖右值看到的字节：

package main

import (
    "fmt"
    "encoding/json"
)

func main() {
    original := json.RawMessage(`{"name":"old"}`)
    left, right := original, original // 两份切片描述仍共享数组
    if err := json.Unmarshal([]byte(`{"name":"new"}`), &left); err != nil {
        panic(err) // 生产代码应把解析错误交给调用方处理
    }
    fmt.Println(string(left))  // {"name":"new"}
    fmt.Println(string(right)) // 可能也变成 {"name":"new"}
}

“可能”取决于容量和新旧数据长度：若底层数组能复用，右值会看到被覆盖的前缀；若容量不足，append 会分配新数组，右值才保持原内容。所以不能靠数据长度碰巧不同来保证隔离。

用深拷贝把 JSON 快照隔离开

最直观的写法是 bytes.Clone。它会为非空字节切片建立独立数组，空值仍保持空语义。需要兼容旧代码风格时，也可以把内容追加到 nil 的 RawMessage 上：

package main

import (
    "bytes"
    "encoding/json"
)

func cloneRaw(src json.RawMessage) json.RawMessage {
    return bytes.Clone(src) // 分配独立数组，避免后续写入互相影响
}

func cloneRawLegacy(src json.RawMessage) json.RawMessage {
    return append(json.RawMessage(nil), src...) // nil 起步，不复用 src 的容量
}

提交代码前的隔离检查

• 要不要长期保存原始 JSON？要保存就先深拷贝。
• 是否把 RawMessage 交给异步任务或另一个 goroutine？交接前复制，避免上游复用缓冲区。
• 是否只读且能证明生命周期不重叠？可以直接赋值，但要把这个约束写在接口说明中。

相关问题

json.RawMessage 是不是字符串？

不是。它保存的是 JSON 编码字节，虽然可以用 string(raw) 查看，却仍遵循切片的长度、容量和别名规则。

重新切片能不能解决数据串改？

不能。重切只生成新的切片描述，除非通过复制操作把字节放入新的底层数组。

什么时候可以不复制？

只有在数据只读、所有权清晰且不会跨异步边界时才适合复用；否则把深拷贝当作接口交接成本更稳妥。