本文介绍在 Go Web 开发中，如何将动态变量（如 JWT token）正确注入结构化 JSON 响应，并通过 json.Encoder 发送给客户端，避免硬编码字符串导致的格式错误与安全风险。
本文介绍在 go web 开发中，如何将动态变量（如 jwt token）正确注入结构化 json 响应，并通过 `json.encoder` 发送给客户端，避免硬编码字符串导致的格式错误与安全风险。
在 Go 中，直接使用反引号或双引号拼接 JSON 字符串（如 `{ success: true, ... }`）不仅违反 JSON 规范（键名和字符串值必须用双引号包裹），还会导致编码失败、XSS 风险及无法动态插入变量。正确做法是利用 Go 的原生 JSON 编码机制——通过 map[string]interface{} 或自定义结构体构建响应数据，再交由 json.NewEncoder 安全序列化。
推荐两种生产级实现方式：
✅ 方式一：使用 map[string]interface{}（适合简单、动态响应）
token := "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
response := map[string]interface{}{
"success": true,
"message": "Successfully logged in.",
"token": token,
}
err := json.NewEncoder(res).Encode(response)
if err != nil {
http.Error(res, "JSON encode error", http.StatusInternalServerError)
return
}
该方式灵活、无需预定义类型，适用于字段较少且可能变化的场景。注意：map 的键必须为 string，值需为 JSON 可序列化类型（如 string, bool, int, float64, nil, 或嵌套 map/slice）。
✅ 方式二：使用命名结构体（推荐用于 API 稳定场景）
type LoginResponse struct {
Success bool `json:"success"`
Message string `json:"message"`
Token string `json:"token"`
}
token := "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
resp := LoginResponse{
Success: true,
Message: "Successfully logged in.",
Token: token,
}
err := json.NewEncoder(res).Encode(resp)
if err != nil {
http.Error(res, "JSON encode error", http.StatusInternalServerError)
return
}
结构体方案具备类型安全、可读性强、易于文档化和 IDE 支持等优势；通过 json 标签可精确控制字段名与序列化行为（如忽略空值：omitempty）。
⚠️ 重要注意事项：
- 切勿使用字符串拼接生成 JSON——既不合法（如
success: true缺少引号），也无法自动转义特殊字符（如message: "User's name"会破坏 JSON 结构）； - 总是检查
json.Encoder.Encode()的返回错误，网络写入或数据不可序列化时可能失败； - 若需返回标准 HTTP 状态码（如 200 OK / 401 Unauthorized），请在调用
Encode前设置res.WriteHeader()； - 对敏感字段（如
token），确保传输层启用 HTTPS，避免明文泄露。
综上，Go 的 encoding/json 包设计初衷即为安全、高效地处理结构化数据。拥抱类型系统与标准编码器，而非绕过它去“手写 JSON”，是构建健壮 Web API 的关键实践。
