Go语言标准库中的encoding/json包是处理JSON数据的主要工具，但在实际开发中，调用json.Unmarshal进行反序列化时经常返回错误。这些问题大多源于Go语言对导出字段的要求以及JSON与结构体之间的映射规则。了解这些常见原因并掌握对应方案，能显著提升调试效率。
常见失败原因与解决方案
1. 结构体字段未导出
Go的json包只能访问首字母大写的导出字段。如果结构体字段是小写，反序列化会静默忽略，不会报错但数据为空。
package main
import (
"encoding/json"
"fmt"
)
type User struct {
name string // 未导出，无法被赋值
Age int
}
func main() {
data := []byte(`{"name":"tom","Age":20}`)
var u User
err := json.Unmarshal(data, &u)
if err != nil {
fmt.Println("error:", err)
}
fmt.Printf("%+vn", u) // 输出 {name: Age:20}
}
解决方法是保证字段导出，并使用json标签映射名称：
type User struct {
Name string `json:"name"`
Age int `json:"Age"`
}
2. 数据类型不匹配
当JSON中的数字带有小数点，但结构体字段是int时，会返回类型错误。应使用float64或自定义类型。
| JSON值 | Go目标类型 | 结果 |
|---|---|---|
| "123" | int | 失败，字符串不能转int |
| 123.5 | int | 失败，小数不能转int |
| 123 | int | 成功 |
3. 时间字段格式不对
JSON中的时间常是字符串，Go的time.Time默认只认RFC3339。若格式不同需实现UnmarshalJSON。
type Event struct {
Time time.Time `json:"time"`
}
func (e *Event) UnmarshalJSON(b []byte) error {
type tmp struct {
Time string `json:"time"`
}
var t tmp
if err := json.Unmarshal(b, &t); err != nil {
return err
}
// 自定义解析格式
parsed, err := time.Parse("2006-01-02 15:04:05", t.Time)
if err != nil {
return err
}
e.Time = parsed
return nil
}
4. 处理null与指针
如果JSON字段可能为null，而目标类型是基本类型，会报错。可使用指针类型接收。
type Item struct {
Price *float64 `json:"price"` // null时指针为nil
}
调试建议
遇到解析错误时，先打印err信息，再用map[string]interface{}暂存数据观察实际结构。此外，使用json.Valid检查原始字节是否合法JSON，能排除输入损坏问题。
记住：json.Unmarshal的第二个参数必须传指针，否则无法写入数据。
小结
Go语言JSON反序列化失败通常集中在字段导出、标签、类型对应和特殊格式处理上。写好结构体标签、合理使用指针与自定义解析，就能覆盖绝大多数场景。
GoJSON反序列化error_handling修改时间：2026-07-27 02:57:17