Go语言中如何在Unmarshal时跳过解析出错的字段？

当使用json.Unmarshal反序列化JSON到结构体时，遇到字段类型不匹配会直接抛出错误，导致所有字段都无法正常解析。要实现只保留有效字段、跳过解析失败字段的需求，可以通过以下两种方式实现：

方法一：为结构体自定义UnmarshalJSON方法 #

通过实现json.Unmarshaler接口，手动处理每个字段的解析逻辑，出错时跳过该字段，保留结构体默认值。

示例代码 #

package main

import (
    "encoding/json"
    "fmt"
)

type Item struct {
    Price    float64 `json:"price"`
    Quantity int     `json:"quantity"`
}

// 自定义UnmarshalJSON方法，逐个处理字段
func (i *Item) UnmarshalJSON(data []byte) error {
    // 先将JSON解析为临时map，存储所有字段的原始JSON数据
    temp := make(map[string]json.RawMessage)
    if err := json.Unmarshal(data, &temp); err != nil {
        return err
    }

    // 解析Price字段：成功则赋值，失败跳过
    if rawPrice, exists := temp["price"]; exists {
        var price float64
        if err := json.Unmarshal(rawPrice, &price); err == nil {
            i.Price = price
        }
    }

    // 解析Quantity字段：仅当类型匹配时赋值，否则保留默认值0
    if rawQty, exists := temp["quantity"]; exists {
        var qty int
        if err := json.Unmarshal(rawQty, &qty); err == nil {
            i.Quantity = qty
        }
    }

    return nil
}

func main() {
    jsonStr := `{"price": 10, "quantity": 2.5}`
    var item Item
    err := json.Unmarshal([]byte(jsonStr), &item)
    if err != nil {
        fmt.Println("反序列化错误:", err)
        return
    }
    fmt.Printf("Price: %.2f, Quantity: %d\n", item.Price, item.Quantity)
    // 输出：Price: 10.00, Quantity: 0
}

方法二：通过中间map结合类型断言解析 #

先将JSON解析为map[string]interface{}，再逐个字段判断类型，符合结构体字段类型时才赋值，不匹配则跳过。

示例代码 #

package main

import (
    "encoding/json"
    "fmt"
)

type Item struct {
    Price    float64 `json:"price"`
    Quantity int     `json:"quantity"`
}

func main() {
    jsonStr := `{"price": 10, "quantity": 2.5}`
    var tempMap map[string]interface{}
    err := json.Unmarshal([]byte(jsonStr), &tempMap)
    if err != nil {
        fmt.Println("反序列化错误:", err)
        return
    }

    var item Item
    // 处理Price字段：断言为float64类型则赋值
    if priceVal, ok := tempMap["price"].(float64); ok {
        item.Price = priceVal
    }

    // 处理Quantity字段：支持int或整数型float64，非整数则跳过
    switch qtyVal := tempMap["quantity"].(type) {
    case int:
        item.Quantity = qtyVal
    case float64:
        if qtyVal == float64(int(qtyVal)) {
            item.Quantity = int(qtyVal)
        }
    }

    fmt.Printf("Price: %.2f, Quantity: %d\n", item.Price, item.Quantity)
    // 输出：Price: 10.00, Quantity: 0
}

两种方法对比 #

• 自定义UnmarshalJSON方法：代码结构更优雅，适合结构体固定、需要长期复用的场景，后续扩展字段只需在方法中添加对应逻辑即可。
• 中间map解析：灵活性更高，适合临时处理简单场景，但字段较多时代码会变得繁琐。

内容的提问来源于stack exchange，提问作者Joey Yi Zhao