本文介绍在 Go 中将结构体字段（如 int、string）动态嵌入 JSON 字节切片的正确方法，重点对比字符串拼接（fmt.Sprintf）与推荐的 json.Marshal 方式，强调安全性、可维护性及避免手动 JSON 构造导致的格式错误或注入风险。
本文介绍在 go 中将结构体字段（如 int、string）动态嵌入 json 字节切片的正确方法，重点对比字符串拼接（`fmt.sprintf`）与推荐的 `json.marshal` 方式，强调安全性、可维护性及避免手动 json 构造导致的格式错误或注入风险。
在 Go 中，不能直接在反引号字符串中插值变量（如 "summary": "Test" + Result.SummaryID），因为 Go 不支持字符串插值或模板字面量。若强行拼接字符串再转为 []byte，不仅易出错（如引号转义缺失、JSON 格式破坏），还可能引入安全风险（如 Description 包含双引号或换行符时导致 JSON 解析失败）。
✅ 推荐方案：使用 encoding/json 安全序列化
最健壮、符合 Go 习惯的方式是定义清晰的数据结构，交由 json.Marshal 处理序列化：
type Result struct {
SummaryID int `json:"summaryid"` // 注意：JSON key 是 "summaryid"
Description string `json:"description"`
}
type JiraFields struct {
Project map[string]string `json:"project"`
Summary string `json:"summary"`
Description string `json:"description"`
IssueType map[string]string `json:"issuetype"`
}
type JiraPayload struct {
Fields JiraFields `json:"fields"`
}
// 构建 payload 实例
result := Result{SummaryID: 123, Description: "Critical bug in auth flow"}
payload := JiraPayload{
Fields: JiraFields{
Project: map[string]string{"key": "DC"},
Summary: "Test" + strconv.Itoa(result.SummaryID),
Description: result.Description,
IssueType: map[string]string{"name": "Bug"},
},
}
byt, err := json.MarshalIndent(payload, "", " ")
if err != nil {
log.Fatal("JSON marshal failed:", err)
}
// byt 现在是格式良好的 UTF-8 JSON []byte⚠️ 注意：原始问题中结构体字段标签为
summaryid，但示例 JSON 写的是"summary"—— 二者必须一致，否则序列化结果不匹配。此处按结构体定义保留"summaryid"，若 API 要求"summary"，请修正结构体标签：`json:"summary"`。
⚠️ 次选方案（仅限简单场景）：fmt.Sprintf + 手动转义（不推荐）
若因特殊限制必须字符串拼接，请务必对所有动态字段进行 JSON 转义：
import "encoding/json"
// 安全转义字符串字段（自动处理引号、换行等）
escapedDesc, _ := json.Marshal(result.Description) // 返回带引号的 JSON 字符串，如 `"hello\"world"`
byt := []byte(fmt.Sprintf(`
{
"fields": {
"project": {"key": "DC"},
"summary": "Test%d",
"description": %s,
"issuetype": {"name": "Bug"}
}
}`, result.SummaryID, escapedDesc))但该方式仍脆弱：无法保证嵌套结构合法性，难以调试，且 json.Marshal 的返回值是 []byte，需额外 string() 转换（或用 fmt.Sprintf("%s", ...)），增加复杂度。
✅ 最佳实践总结
-
永远优先使用
json.Marshal/json.MarshalIndent：它自动处理类型转换、转义、缩进和语法校验； -
避免手写 JSON 字符串：尤其当字段来自用户输入或数据库时，手动拼接极易引发
invalid character错误； - 利用结构体标签精准控制 JSON key 名称，确保与目标 API 协议严格一致；
- 如需高度动态字段（如运行时决定键名），可结合
map[string]interface{}或json.RawMessage，但仍应通过json.Marshal序列化。
最终，一行 json.MarshalIndent(payload, "", " ") 不仅更短、更安全，也真正体现了 Go “用标准库做正确的事”的设计哲学。
