本文详解如何正确遍历 go 的 map 并序列化为标准 json 数组（而非单个对象），解决因误用赋值导致仅返回最后一项、以及 int 类型 map 键无法直接 json 序列化的常见问题。
本文详解如何正确遍历 go 的 map 并序列化为标准 json 数组（而非单个对象），解决因误用赋值导致仅返回最后一项、以及 int 类型 map 键无法直接 json 序列化的常见问题。
在 Go Web 开发中，将内存中的 map 数据以结构化 JSON 格式暴露为 API 响应是高频需求。但初学者常陷入两个典型误区：一是误将循环内赋值当作追加（导致只保留最后一次迭代结果）；二是忽略 JSON 规范对键类型的限制（JSON 对象的键必须为字符串，而 Go 的 map[int]string 无法直接 json.Marshal 成合法 JSON 对象）。
所幸，本场景的目标并非序列化原始 map，而是将其键值对转换为统一结构的 JSON 数组——这恰好规避了 int 键的限制，因为数组元素是对象，其内部字段（如 "key" 和 "value"）可自由定义类型。
以下是修正后的完整实现（基于 httprouter，兼容您原有结构）：
type UserController struct{}
func NewUserController() *UserController {
return &UserController{}
}
type Data struct {
Key int `json:"key"` // 字段名建议小写，符合 Go 惯例；tag 明确指定 JSON 键
Value string `json:"value"`
}
var datamap = map[int]string{
101: "apple",
202: "banana",
303: "cherry",
}
func (uc UserController) getallkeys(w http.ResponseWriter, r *http.Request, p httprouter.Params) {
// 正确：声明空切片，并使用 append 动态扩容
var result []Data
for k, v := range datamap {
result = append(result, Data{Key: k, Value: v})
}
// 使用 json.Marshal 处理错误（生产环境不可忽略）
jsonData, err := json.Marshal(result)
if err != nil {
http.Error(w, "JSON serialization failed", http.StatusInternalServerError)
return
}
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
w.Write(jsonData) // 更安全：避免 fmt.Fprintf 的格式风险
}关键修正点说明：
- ✅ 切片追加逻辑：原代码 uj = Users{...} 每次循环都重新赋值，覆盖前值。改为 result = append(result, ...) 确保所有键值对被累积。
- ✅ 类型声明简化：无需自定义 type Users []Data，直接使用 []Data 更清晰、无歧义。
- ✅ 错误处理：json.Marshal 可能失败（如含不可序列化字段），必须检查 err，避免静默崩溃。
- ✅ 响应写入优化：用 w.Write() 替代 fmt.Fprintf(w, "%s", result)，避免额外字符串格式化开销与潜在转义问题。
注意事项：
- 若需支持前端按 key 排序，可在循环前对 map 的 key 切片排序（Go map 遍历顺序不保证）；
- 生产环境应启用 HTTP 中间件统一处理 CORS、日志、panic 恢复等；
- datamap 若为全局变量，需考虑并发安全（添加 sync.RWMutex 或改用 sync.Map）。
最终响应将严格符合预期格式：
[
{"key":101,"value":"apple"},
{"key":202,"value":"banana"},
{"key":303,"value":"cherry"}
] 
