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

在Go语言的日常开发中，JSON数据的解析是非常常见的操作，json.Unmarshal是官方标准库提供的核心解析函数。但在处理包含指针字段的结构体时，如果解析逻辑不够严谨，很容易出现nil指针解引用的问题，导致程序直接panic。了解其产生的原因并掌握正确的实践方法，是Go开发者必备的技能。

nil指针解引用的常见场景

首先我们看一个典型的错误示例，结构体定义了指针类型的字段，解析JSON后直接访问该字段的内部属性，就可能触发nil指针解引用。

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name *string `json:"name"`
	Age  *int    `json:"age"`
}

func main() {
	jsonStr := `{"name": "test"}`
	var u User
	err := json.Unmarshal([]byte(jsonStr), &u)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	// 这里age字段是nil，直接解引用会panic
	fmt.Println(*u.Age)
}

上面的代码中，JSON字符串没有包含age字段，解析后u.Age的值为nil，执行*u.Age时就会触发runtime error: invalid memory address or nil pointer dereference。

避免nil指针解引用的实践方法

1. 解析后先校验指针是否为nil

最基础的做法是在访问指针字段之前，先判断指针是否为nil，避免在nil指针上执行解引用操作。

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name *string `json:"name"`
	Age  *int    `json:"age"`
}

func main() {
	jsonStr := `{"name": "test"}`
	var u User
	err := json.Unmarshal([]byte(jsonStr), &u)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	if u.Age != nil {
		fmt.Println("年龄:", *u.Age)
	} else {
		fmt.Println("年龄字段不存在或为空")
	}
	if u.Name != nil {
		fmt.Println("姓名:", *u.Name)
	}
}

2. 结构体字段优先使用值类型

如果字段不存在空值或者nil的场景，优先使用值类型而不是指针类型定义结构体字段，从根源上避免nil指针的问题。值类型的零值也能满足大部分场景的使用需求。

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
}

func main() {
	jsonStr := `{"name": "test"}`
	var u User
	err := json.Unmarshal([]byte(jsonStr), &u)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	// 值类型不会是nil，直接访问即可，Age的零值是0
	fmt.Println("姓名:", u.Name)
	fmt.Println("年龄:", u.Age)
}

3. 自定义Unmarshal逻辑处理默认值

如果业务上需要指针类型，且希望在字段不存在时设置默认值而不是nil，可以自定义结构体的UnmarshalJSON方法，在解析时处理指针的初始化逻辑。

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name *string `json:"name"`
	Age  *int    `json:"age"`
}

// 自定义UnmarshalJSON方法
func (u *User) UnmarshalJSON(data []byte) error {
	// 定义临时结构体，字段使用值类型接收解析结果
	type TempUser struct {
		Name string `json:"name"`
		Age  int    `json:"age"`
	}
	var temp TempUser
	if err := json.Unmarshal(data, &temp); err != nil {
		return err
	}
	// 初始化指针字段，赋值临时结构体的结果
	u.Name = &temp.Name
	u.Age = &temp.Age
	return nil
}

func main() {
	jsonStr := `{"name": "test"}`
	var u User
	err := json.Unmarshal([]byte(jsonStr), &u)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	// 此时Age指针已经被初始化，不会是nil
	fmt.Println("年龄:", *u.Age)
	fmt.Println("姓名:", *u.Name)
}

4. 使用omitempty标签配合指针处理可选字段

如果字段是可选的，且需要在序列化时忽略零值，可以结合omitempty标签和指针类型使用，解析时如果字段不存在，指针就是nil，使用时做好校验即可。

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name *string `json:"name,omitempty"`
	Age  *int    `json:"age,omitempty"`
}

func main() {
	jsonStr := `{"name": "test"}`
	var u User
	err := json.Unmarshal([]byte(jsonStr), &u)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}
	// 序列化时会忽略nil的字段
	data, _ := json.Marshal(u)
	fmt.Println("序列化结果:", string(data))
}

总结

避免json.Unmarshal时的nil指针解引用，核心是要明确结构体字段的设计意图，优先使用值类型减少指针的使用场景，对于必须使用指针的字段，要在访问前做好nil校验，或者自定义解析逻辑初始化默认值。合理的结构体定义和严谨的校验逻辑，能够有效避免这类运行时错误，提升程序的稳定性。

json.UnmarshalGo语言nil指针解引用结构体解析修改时间：2026-06-15 03:18:15