在使用Go语言开发后端服务时，处理JSON数据几乎是每个项目都会遇到的核心任务。然而，在实际开发中，一个常见却容易被忽视的问题是：当JSON字段可能同时包含整数和null值时，如何正确地进行反序列化？尤其是在第三方API返回的数据结构不稳定或字段类型动态变化的场景下，这一问题尤为突出。若处理不当，程序可能会抛出json: cannot unmarshal number into Go value of type *int这类错误，导致服务异常。

问题背景

假设我们正在对接一个外部天气API，其返回的JSON中某个字段temperature有时是整数（如25），有时为null（表示数据缺失）。我们尝试用标准的struct结构体来接收：

go type Weather struct { Temperature int `json:"temperature"` }

当temperature为null时，Go的encoding/json包会尝试将null赋值给int类型字段，由于int是值类型，无法接受null，于是反序列化失败，程序崩溃。

常见错误尝试

开发者的第一反应可能是将字段改为指针类型：

go type Weather struct { Temperature *int `json:"temperature"` }

这确实能解决null的问题——null会被解析为nil。但新的问题出现了：如果原始JSON中的数字是以字符串形式传递的，例如"temperature": "25"，此时又会报错：json: cannot unmarshal string into Go value of type *int。更复杂的是，某些系统可能交替使用数字和字符串格式，甚至混合null，这就让标准类型难以应对。

根本原因分析

Go语言的encoding/json包在反序列化时严格遵循类型匹配原则。int、*int等原生类型不具备“兼容多种输入”的能力。而JSON本身是一种弱类型格式，允许字段在不同情况下呈现不同数据形态。这种“强类型语言”与“弱类型数据格式”之间的矛盾，正是问题的根源。

此外，Go的interface{}虽然可以接收任意类型，但在解码后仍需手动判断底层类型，否则无法安全使用。例如：

go var data map[string]interface{} json.Unmarshal(jsonBytes, &data) temp := data["temperature"] switch v := temp.(type) { case float64: // JSON数字默认解析为float64 case string: // 字符串情况 case nil: // null情况 }

这种方式虽然灵活，但代码冗长，且容易出错，尤其在嵌套结构中维护成本极高。

实战解决方案：自定义类型解析

最优雅的解决方式是定义一个自定义类型，实现json.Unmarshaler接口，统一处理各种输入情况。以下是一个通用的可为空整数类型：

go
type NullableInt struct {
Value int
Valid bool
}

func (ni *NullableInt) UnmarshalJSON(data []byte) error {
var v interface{}
if err := json.Unmarshal(data, &v); err != nil {
return err
}

switch val := v.(type) {
case float64:
    ni.Value = int(val)
    ni.Valid = true
case string:
    i, err := strconv.Atoi(val)
    if err != nil {
        ni.Valid = false
        return nil // 可选择忽略转换失败
    }
    ni.Value = i
    ni.Valid = true
case nil:
    ni.Valid = false
default:
    ni.Valid = false
}
return nil

}

然后在结构体中使用：

go type Weather struct { Temperature NullableInt `json:"temperature"` }

这样，无论接收到的是数字、字符串还是null，都能安全解析。使用时只需判断Valid字段即可：

go if weather.Temperature.Valid { fmt.Printf("温度: %d°C", weather.Temperature.Value) } else { fmt.Println("温度数据不可用") }

进阶优化：泛型支持（Go 1.18+）

对于多个类似字段，可以借助Go的泛型机制抽象出通用的可空类型处理器，减少重复代码。例如：

go type Nullable[T comparable] struct { Value T Valid bool }

再配合泛型版的UnmarshalJSON，可进一步提升代码复用性。

总结

在Go中处理JSON时，面对整数与null共存的字段，不能依赖简单的类型声明。通过实现UnmarshalJSON方法，我们可以精准控制解析逻辑，使程序更具健壮性和容错能力。这种模式不仅适用于整数，也可扩展至布尔、字符串等其他类型，是构建高可用API客户端的重要技巧。