如何在Golang中处理JSON解析错误

答案是：处理Golang中JSON解析错误需检查json.Unmarshal的error返回值，确保数据结构匹配，使用指针或interface{}应对字段缺失或类型不确定情况，提前用interface{}验证JSON格式合法性，并通过实现json.Unmarshaler接口处理复杂类型转换，如字符串转数字或时间。示例表明类型不匹配会触发具体错误，而合理设计结构体和自定义解析逻辑可避免解析失败。每次解析都应检查error以捕获语法或映射问题，从而提升程序健壮性。

在Golang中处理JSON解析错误，关键在于正确使用 encoding/json 包并检查返回的 error。大多数问题出现在数据结构不匹配、字段类型错误或输入格式无效时。只要每次调用 json.Unmarshal 或解码器读取时检查 error，就能有效捕捉和处理异常。

检查 Unmarshal 返回的错误

每次调用 json.Unmarshal 时，必须检查其第二个返回值 error。这是发现解析失败的第一步。

示例：

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

30

查看详情

data := `{"name": "Alice", "age": "not_a_number"}`
var v struct {
    Name string
    Age  int
}
err := json.Unmarshal([]byte(data), &v)
if err != nil {
    log.Printf("JSON 解析失败: %v", err)
}

上面代码中，"not_a_number" 无法转成 int，会触发 json: cannot unmarshal string into Go struct field .age of type int 错误。

立即学习“go语言免费学习笔记（深入）”；

使用指针或接口应对不确定结构

当 JSON 结构可能变化或部分字段缺失时，使用指针或 interface{} 可避免解析中断。

示例：

var v struct {
    Name string
    Age  *int  // 允许为空
}
data := `{"name": "Bob"}`
json.Unmarshal([]byte(data), &v) // 不报错，Age 为 nil

提前验证 JSON 格式

若输入来源不可控（如用户上传），可在 Unmarshal 前先尝试解析为通用结构，确认基本合法性。

var dummy interface{}
if err := json.Unmarshal([]byte(input), &dummy); err != nil {
    log.Printf("无效 JSON 格式: %v", err)
    return
}
// 再进行具体结构解析

这样可以区分是语法错误还是结构映射问题，便于日志记录和用户提示。

自定义类型处理复杂转换

对于特殊格式（如时间字符串转 time.Time，或字符串数字转数值），可实现 json.Unmarshaler 接口。

通过重写 UnmarshalJSON 方法，可以在解析时捕获并转换异常格式，避免整体失败。

type CustomInt int

func (ci *CustomInt) UnmarshalJSON(data []byte) error {
    var s string
    if err := json.Unmarshal(data, &s); err == nil {
        i, err := strconv.Atoi(s)
        if err == nil {
            *ci = CustomInt(i)
            return nil
        }
    }
    // 尝试直接作为数字解析
    var i int
    if err := json.Unmarshal(data, &i); err == nil {
        *ci = CustomInt(i)
        return nil
    }
    return fmt.Errorf("无法解析为整数: %s", data)
}

这样即使前端传了字符串数字，也能成功解析而不报错。

基本上就这些。关键是每次解析都检查 error，合理设计结构体字段类型，并在必要时使用自定义逻辑兜底。不复杂但容易忽略细节。

以上就是如何在Golang中处理JSON解析错误的详细内容，更多请关注php中文网其它相关文章！