Go语言的标准库encoding/json提供了便捷的JSON解析能力，但在实际使用中，如果数据结构定义不合理或者解析逻辑不严谨，很容易出现空指针解引用错误，这类错误会直接触发panic导致程序终止。下面先介绍相关的处理方案。
常见错误场景分析
最常见的触发场景是定义嵌套的结构体时，内层结构体字段使用指针类型，而JSON数据中该字段为null或者不存在，解析后指针为nil，此时直接访问内层字段就会触发空指针解引用。
比如下面的结构体定义和解析逻辑：
package main
import (
"encoding/json"
"fmt"
)
type Inner struct {
Value string `json:"value"`
}
type Outer struct {
Inner *Inner `json:"inner"`
}
func main() {
// JSON中inner字段为null
data := []byte(`{"inner": null}`)
var o Outer
json.Unmarshal(data, &o)
// 此处直接访问o.Inner.Value会触发空指针解引用panic
fmt.Println(o.Inner.Value)
}
运行上述代码会直接抛出panic，提示空指针解引用错误。
安全处理方案
方案一：解析后做nil判断
在访问可能为nil的指针字段前，先判断指针是否为nil，这是最基础也最通用的处理方式。
package main
import (
"encoding/json"
"fmt"
)
type Inner struct {
Value string `json:"value"`
}
type Outer struct {
Inner *Inner `json:"inner"`
}
func main() {
data := []byte(`{"inner": null}`)
var o Outer
json.Unmarshal(data, &o)
if o.Inner != nil {
fmt.Println(o.Inner.Value)
} else {
fmt.Println("inner字段为空或不存在")
}
}
方案二：使用非指针类型的嵌套结构体
如果业务场景中内层结构体字段不是必须为空，可以将嵌套结构体定义为值类型，这样即使JSON中对应字段为null，解析后也会得到零值的结构体，不会触发空指针错误。
package main
import (
"encoding/json"
"fmt"
)
type Inner struct {
Value string `json:"value"`
}
type Outer struct {
Inner Inner `json:"inner"`
}
func main() {
data := []byte(`{"inner": null}`)
var o Outer
json.Unmarshal(data, &o)
// 此时o.Inner是零值结构体，Value为空字符串，不会panic
fmt.Println(o.Inner.Value)
}
方案三：自定义JSON解析逻辑
如果需要在解析阶段就处理null值的情况，可以实现json.Unmarshaler接口，自定义解析逻辑，比如将null值转换为默认初始化后的结构体指针。
package main
import (
"encoding/json"
"fmt"
)
type Inner struct {
Value string `json:"value"`
}
func (i *Inner) UnmarshalJSON(data []byte) error {
// 如果是null，初始化空结构体
if string(data) == "null" {
*i = Inner{}
return nil
}
// 否则正常解析
type Alias Inner
return json.Unmarshal(data, (*Alias)(i))
}
type Outer struct {
Inner *Inner `json:"inner"`
}
func main() {
data := []byte(`{"inner": null}`)
var o Outer
json.Unmarshal(data, &o)
// 此时o.Inner已经被初始化为空结构体，不会panic
fmt.Println(o.Inner.Value)
}
方案对比与选择建议
不同方案的适用场景不同，可以通过下面的表格进行选择：
| 方案 | 适用场景 | 优缺点 |
|---|---|---|
| nil判断 | 所有可能出现空指针的场景 | 实现简单，但是需要每个访问点都加判断，容易遗漏 |
| 值类型嵌套 | 内层结构体不需要区分存在和空值的场景 | 无需额外判断，但是无法区分字段是不存在还是值为空 |
| 自定义解析 | 需要统一处理null值逻辑的场景 | 逻辑集中，复用性好，但是实现成本稍高 |
注意事项
除了嵌套结构体的场景，还要注意切片、map等引用类型的字段，JSON中对应字段为null时，解析后切片和map会是nil，直接操作也可能触发错误，同样需要做nil判断或者使用合适的初始化逻辑。
另外，在使用json.RawMessage延迟解析的场景下，也要先判断RawMessage是否为空，再进行后续的解析操作，避免空指针问题。