本文详解 Go 中 json.Unmarshal 报错 “cannot unmarshal array into Go value of type” 的根本原因与解决方案，重点说明结构体字段类型必须严格匹配 JSON 数据形态（如数组需对应切片），并提供可直接运行的修复示例。
本文详解 go 中 `json.unmarshal` 报错 “cannot unmarshal array into go value of type” 的根本原因与解决方案，重点说明结构体字段类型必须严格匹配 json 数据形态（如数组需对应切片），并提供可直接运行的修复示例。
在 Go 中解析 JSON 时，若结构体字段类型与 JSON 实际数据结构不一致，json.Unmarshal 会立即报错，典型错误如：json: cannot unmarshal array into Go value of type main.MonitorServerInfo
该错误明确指出：JSON 中 monitor_servers_info 是一个数组（[...]），但你的 Go 结构体却将其声明为单个结构体值（MonitorServerInfo 类型），而非切片（[]MonitorServerInfo 或等效嵌套切片）。问题根源正在于 ConfigServer.ServerInfo 字段的类型定义。
回顾原始代码：
type MonitorServerInfo struct {
Servers []ServerInfoStrap // ❌ 此字段未导出（首字母小写），且未加 json tag
}
type ConfigServer struct {
ServerInfo MonitorServerInfo `json:"monitor_servers_info"` // ❌ 期望解码为单个对象，但 JSON 给的是数组
// ...
}
此处 MonitorServerInfo 是一个普通结构体，其内部 Servers 字段不可导出（servers 小写），json 包无法访问；更重要的是，json:"monitor_servers_info" 标签绑定的字段类型不是切片，无法接收 JSON 数组。
✅ 正确做法是跳过中间包装结构体，直接将 monitor_servers_info 映射为 []ServerInfoStrap 切片：
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
type ConfigServer struct {
ServerInfo []ServerInfoStrap `json:"monitor_servers_info"` // ✅ 数组 → 切片
ConnServer SentryServer `json:"sentry_server"`
DeadTime string `json:"deadtime"`
}
同时确保嵌套结构体字段可导出且 tag 准确：
type ServerInfo struct {
Host string `json:"host"`
Port int64 `json:"port"`
Magic string `json:"magic"`
Params string `json:"params"`
Interval int64 `json:"interval"`
}
type ServerInfoStrap struct {
ConnInfo ServerInfo `json:"server_info"` // ✅ 字段大写 + 正确 tag
}
完整可运行示例（含错误处理优化）：
func readFile(filename string) (ConfigServer, error) {
bytes, err := ioutil.ReadFile(filename)
if err != nil {
return ConfigServer{}, fmt.Errorf("read file %s: %w", filename, err)
}
var config ConfigServer
if err := json.Unmarshal(bytes, &config); err != nil {
return ConfigServer{}, fmt.Errorf("unmarshal config: %w", err)
}
return config, nil
}
⚠️ 注意事项：
- Go 结构体字段必须首字母大写（导出） 才能被
encoding/json访问； -
jsontag 值须与 JSON 键名完全一致（区分大小写）； - JSON 数组
[]→ Go 中必须为切片[]T，不可为单个结构体或未导出字段； - 若需保留
MonitorServerInfo作为逻辑封装类型，应将其定义为切片别名：type MonitorServerInfo []ServerInfoStrap // 然后在 ConfigServer 中使用： // ServerInfo MonitorServerInfo `json:"monitor_servers_info"`
通过精准匹配 JSON 形态与 Go 类型，即可彻底避免此类反序列化错误。
