go 中使用 json.encoder 发送结构体时，若先手动序列化再编码，会导致 json 字符串被二次编码为字符串，从而在接收端解码失败。本文详解问题根源及正确做法。
go 中使用 json.encoder 发送结构体时，若先手动序列化再编码，会导致 json 字符串被二次编码为字符串，从而在接收端解码失败。本文详解问题根源及正确做法。
在 Go 的跨服务 JSON 通信中，一个常见却隐蔽的错误是对已序列化的 JSON 数据再次调用 json.Encoder.Encode()，这会引发 json: cannot unmarshal string into Go value of type main.NewContainerJSON 这类典型解码错误。根本原因在于：数据被双重编码（double-encoding），使接收方实际收到的是一个 JSON 字符串（如 "{"ContainerName":"test",...}"），而非原始 JSON 对象。
? 问题定位：双重编码是如何发生的？
观察第一台服务器的关键代码：
c := newContainerJSON{ /* ... */ }
d, _ := json.Marshal(c) // ✅ d 是 []byte，内容为：{"ContainerName":"...", ...}
encoder.Encode(d) // ❌ 错误！Encode([]byte) 会将字节切片作为单个字符串转义后写入
json.Encoder.Encode(v interface{}) 的作用是：将任意 Go 值 v 序列化为 JSON 并写入底层 io.Writer。当传入 d（即 []byte）时，Go 的 json 包会将其视为一个字节切片，并按 JSON 规范编码为带引号的字符串（例如："eyJDb250YWluZXJOYW1lIjoi...），即原始 JSON 被包裹在一对双引号中，变成 JSON 字符串字面量——这正是接收端解析失败的根源：它试图把一个字符串（"{"key":"val"}"）解码进结构体，自然报错。
✅ 正确做法：直接编码结构体，而非字节切片
应跳过手动 json.Marshal()，让 json.Encoder 直接处理原始结构体：
// ✅ 正确：Encoder 直接序列化结构体
conn, err := net.Dial("tcp", "127.0.0.1:8081")
if err != nil {
checkError(err)
return
}
defer conn.Close() // 避免连接泄漏
encoder := json.NewEncoder(conn)
if err := encoder.Encode(c); err != nil { // ← 传入 struct 实例 c，非 []byte
checkError(err)
return
}
? 提示：json.Encoder.Encode() 内部已完整处理序列化逻辑，无需、也不应提前 Marshal。
? 接收端注意事项：移除错误的 json:",string" 标签
第二台服务器结构体中的 json:",string" 标签是严重误用：
type NewContainerJSON struct {
ContainerName string `json:",string"` // ❌ 错误！强制将字段解析为字符串字面量
// ...
}
该标签含义是：“将此字段的 JSON 值始终当作字符串解析”，即要求输入 JSON 中对应字段必须是字符串（如 "containerName": "myapp"），且解码时会尝试把该字符串再解析一次（例如转数字）。此处不仅不必要，还会干扰正常字符串字段解码。应完全删除所有 ",string" 标签：
type NewContainerJSON struct {
ContainerName string `json:"containerName"` // ✅ 显式指定 key 名（推荐）
BaseServer string `json:"baseServer"`
CMS string `json:"cms"`
WebsiteName string `json:"websiteName"`
DBrootPWD string `json:"dbRootPWD"`
DBadminUname string `json:"dbAdminUname"`
DBadminPWD string `json:"dbAdminPwd"`
}
✅ 小技巧：使用 json:"fieldName" 显式映射可提升可读性与健壮性；Go 默认按字段名首字母大写自动匹配（如 ContainerName → "containerName"），但显式声明更可靠。
? 完整修复后通信流程
| 步骤 | 操作 | 输出示例 |
|---|---|---|
| 1️⃣ 发送端（:8080） | encoder.Encode(c) | { "containerName":"MyApp", "baseServer":"Ubuntu 14.04", ... }（纯 JSON 对象） |
| 2️⃣ 网络传输 | TCP 字节流 | 原始 JSON 字节，无额外引号或转义 |
| 3️⃣ 接收端（:8081） | decoder.Decode(&b) | 成功填充 NewContainerJSON 字段 |
⚠️ 其他关键改进建议
- 错误处理不可忽略：原代码中 _ 忽略 json.Marshal 和 encoder.Encode 的错误，可能导致静默失败。务必检查并处理。
- 连接生命周期管理：发送后应 conn.Close()；接收端 listener.Accept() 后也需关闭 conn（当前代码已做，但建议加 defer）。
- HTTP 表单键名一致性：确保 HTML 表单 name 属性（如 dbRootPWD）与 Go 结构体 JSON tag（如 "dbRootPWD"）严格一致，否则解码为零值。
遵循以上修正，即可彻底解决 cannot unmarshal string into Go value 错误，构建稳定可靠的 Go JSON 服务间通信。
