Go语言中使用json.Unmarshal时如何避免nil指针解引用错误

在Go语言的日常开发中，json.Unmarshal是处理JSON数据解析的核心函数，但当解析的目标结构体包含指针类型字段时，很容易触发nil指针解引用错误，导致程序直接panic。这类错误的排查难度较高，需要从结构体定义到解析流程的全链路规避。

nil指针解引用错误的常见场景

首先我们通过一个典型示例来看错误是如何产生的，以下代码在解析JSON时会直接触发panic：

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name   *string
	Age    *int
	Address *struct {
		City  string
		Street string
	}
}

func main() {
	jsonStr := `{"Name":"张三","Age":20}`
	var u User
	// 直接调用json.Unmarshal，Address指针未被初始化
	err := json.Unmarshal([]byte(jsonStr), &u)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	// 尝试访问Address的City字段，此时Address为nil，触发解引用错误
	fmt.Println(u.Address.City)
}

上述代码中，JSON字符串没有包含Address字段，json.Unmarshal不会自动初始化User结构体的Address指针，此时Address的值为nil，直接访问其City字段就会触发nil pointer dereference错误。

规避错误的核心实践方案

1. 初始化结构体时预分配指针字段

最基础的规避方式是在声明结构体变量时，先初始化所有指针字段，确保指针不为nil：

func main() {
	jsonStr := `{"Name":"张三","Age":20}`
	// 初始化所有指针字段
	var u User
	u.Name = new(string)
	u.Age = new(int)
	u.Address = &struct {
		City  string
		Street string
	}{}
	err := json.Unmarshal([]byte(jsonStr), &u)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	// 此时Address已被初始化，即使JSON中没有对应字段，也不会触发nil解引用
	if u.Address != nil {
		fmt.Println(u.Address.City)
	}
}

这种方式适合指针字段较少的场景，但如果结构体指针字段较多，手动初始化会比较繁琐。

2. 自定义UnmarshalJSON方法

对于复杂的包含指针字段的结构体，可以自定义UnmarshalJSON方法，在解析过程中自动初始化指针字段，避免nil问题：

func (u *User) UnmarshalJSON(data []byte) error {
	// 定义临时结构体，用来接收解析的基础数据
	type TempUser struct {
		Name    *string `json:"Name"`
		Age     *int    `json:"Age"`
		Address *struct {
			City   string `json:"City"`
			Street string `json:"Street"`
		} `json:"Address"`
	}
	var temp TempUser
	// 先初始化指针字段，避免nil
	temp.Name = new(string)
	temp.Age = new(int)
	temp.Address = &struct {
		City   string `json:"City"`
		Street string `json:"Street"`
	}{}
	// 解析到临时结构体
	if err := json.Unmarshal(data, &temp); err != nil {
		return err
	}
	// 将临时结构体的数据赋值给原结构体
	u.Name = temp.Name
	u.Age = temp.Age
	u.Address = temp.Address
	return nil
}

自定义解析方法可以统一处理所有指针字段的初始化逻辑，不用在每次解析时重复写初始化代码。

3. 解析后做nil校验再访问指针字段

即使做了初始化，也可能存在JSON数据中字段值为null的情况，因此访问指针字段前必须做nil校验：

func printUserInfo(u User) {
	if u.Name != nil {
		fmt.Println("姓名:", *u.Name)
	}
	if u.Age != nil {
		fmt.Println("年龄:", *u.Age)
	}
	if u.Address != nil {
		fmt.Println("城市:", u.Address.City)
		fmt.Println("街道:", u.Address.Street)
	}
}

这种校验逻辑可以封装成结构体的方法，减少重复代码。

4. 合理使用JSON标签

如果指针字段是可选字段，可以在结构体定义时添加omitempty标签，同时在解析后判断字段是否为nil：

type User struct {
	Name   *string `json:"Name,omitempty"`
	Age    *int    `json:"Age,omitempty"`
	Address *struct {
		City  string `json:"City"`
		Street string `json:"Street"`
	} `json:"Address,omitempty"`
}

当JSON中没有对应字段或者字段值为null时，指针会保持nil，此时结合nil校验就可以安全访问。

错误排查小技巧

如果遇到无法定位的nil指针解引用错误，可以在解析后打印结构体的指针字段值，快速定位哪个指针未被初始化：

func main() {
	jsonStr := `{"Name":"张三"}`
	var u User
	err := json.Unmarshal([]byte(jsonStr), &u)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	fmt.Printf("Name指针: %v, Age指针: %v, Address指针: %vn", u.Name, u.Age, u.Address)
}

通过打印指针的地址值，可以快速判断哪些指针没有被正确初始化，缩小排查范围。

综合来看，在实际项目中可以将自定义UnmarshalJSON和解析后nil校验结合使用，既能减少重复代码，又能最大程度避免nil指针解引用错误的发生。

Gojson.Unmarshalnil指针解引用结构体指针修改时间：2026-06-19 20:24:43