如何在 Go 中正确初始化 json.RawMessage 字面量

json.RawMessage 底层是 []byte 类型，不能直接用字符串字面量赋值，而需显式转换为字节切片（如 []byte("{}")），否则编译失败；若需延迟解析或避免重复序列化，应配合指针类型 *json.RawMessage 使用。

`json.rawmessage` 底层是 `[]byte` 类型，不能直接用字符串字面量赋值，而需显式转换为字节切片（如 `[]byte("{}")`），否则编译失败；若需延迟解析或避免重复序列化，应配合指针类型 `*json.rawmessage` 使用。

在 Go 的 JSON 处理中，json.RawMessage 是一个非常实用的类型，它允许你延迟解析某段 JSON 数据，或将已序列化的 JSON 片段原样嵌入结构体中，避免二次编码/解码开销。但因其底层是 []byte（而非 string），无法直接使用字符串字面量初始化结构体字段——这是初学者常遇到的编译错误根源。

例如，以下写法是非法的：

type ErrorMessage struct {
    Timestamp string          `json:"timestamp"`
    Message   json.RawMessage `json:"message"`
}

func getTestData() ErrorMessage {
    return ErrorMessage{
        Timestamp: "test-time",
        Message:   "{}", // ❌ 编译错误：cannot use string literal as json.RawMessage
    }
}

✅ 正确做法是将字符串显式转为 []byte：

func getTestData() ErrorMessage {
    return ErrorMessage{
        Timestamp: "test-time",
        Message:   []byte(`{"code":400,"reason":"invalid input"}`), // ✅ 合法字面量
    }
}

⚠️ 注意事项：

畅图

AI可视化工具

下载

• json.RawMessage 本身是 []byte 的别名，因此必须以字节切片形式提供原始 JSON 数据（推荐使用反引号包裹的原始字符串，避免转义干扰）；

• 若希望在结构体中支持 nil 值（例如可选字段），应使用 *json.RawMessage 类型，并在需要时分配：

  type ErrorMessage struct {
      Timestamp string             `json:"timestamp"`
      Message     *json.RawMessage `json:"message,omitempty"`
  }
  
  func getTestDataWithOptional() ErrorMessage {
      raw := []byte(`{"error":"timeout"}`)
      return ErrorMessage{
          Timestamp: "2024-06-01T12:00:00Z",
          Message:   &json.RawMessage(raw), // ✅ 取地址后赋值给指针字段
      }
  }

• json.RawMessage 不会自动验证 JSON 格式合法性——传入非法 JSON（如 []byte("{")）会在后续 json.Marshal 或 json.Unmarshal 时才报错，建议在构造阶段做轻量校验（如 json.Valid()）。

总结：json.RawMessage 字面量的本质是 []byte 字面量，牢记“字符串 → []byte”的显式转换逻辑，再结合指针语义与业务需求（是否允许 nil、是否需延迟解析），即可安全、高效地构建灵活的 JSON 结构。