在 Java 开发中，NullPointerException堪称新手程序员的 “头号敌人”。尤其是在操作包含多层对象结构的代码时，明明已经new了外部对象，却还是在调用内部对象的方法时翻车。今天就通过一个贴近实际开发的案例，聊聊这个问题的根源和解决办法。

一、一个典型的 “翻车” 案例

假设我们在开发一个用户管理系统，需要定义 “用户” 和 “用户详情” 两个关联对象，代码如下：

// 用户详情类（包含地址、生日等信息）
@Data
public class UserDetail {
    private String address; // 家庭地址
    private String birthday; // 生日
}

// 用户类（包含基本信息和详情）
@Data
public class User {
    private String username; // 用户名
    private Integer age; // 年龄
    private UserDetail detail; // 用户详情（引用类型）
}

业务代码中，我们想创建一个用户并设置其详情：

public class Main {
    public static void main(String[] args) {
        // 创建用户对象
        User user = new User();
        user.setUsername("张三");
        user.setAge(25);
        
        // 尝试设置用户详情
        user.getDetail().setAddress("北京市朝阳区"); // 这里会报错！
    }
}

运行后直接抛出异常：
java.lang.NullPointerException: Cannot invoke “UserDetail.setAddress(String)” because the return value of “User.getDetail()” is null

二、问题根源：引用类型的默认值是 null

为什么会报错？原因很简单：Java 中引用类型的字段，默认初始值是 null。
当我们执行new User()时，JVM 会为User对象分配内存，并对其字段进行默认初始化：
基本类型age（Integer）默认值为null（包装类属于引用类型）；
引用类型detail（UserDetail）默认值为null（未指向任何对象）。
此时user.getDetail()返回的是null，调用null.setAddress(…)自然会抛出空指针异常。

三、Lombok 注解背锅了？不，是理解错了

有同学可能会问：我用了 Lombok 的@Data注解，它为什么不自动帮我初始化UserDetail？
这里要明确：Lombok 的注解（如 @Data、@Getter、@Setter）仅用于生成 getter、setter 等方法，不会改变 Java 的默认初始化规则。无论是否使用 Lombok，引用类型字段的默认值依然是null。

四、3 种解决方案，从根源避免空指针

要解决这个问题，核心是在使用内部对象前，确保它已经被初始化（即创建了实例）。

方案 1：手动初始化内部对象（简单直接）
在使用内部对象前，手动new一个实例并赋值：

public class Main {
    public static void main(String[] args) {
        User user = new User();
        user.setUsername("张三");
        user.setAge(25);
        
        // 手动初始化内部对象
        user.setDetail(new UserDetail());
        // 现在可以安全操作了
        user.getDetail().setAddress("北京市朝阳区");
    }
}

适用场景：内部对象并非每次都需要用到，按需初始化可节省内存。

方案 2：定义字段时直接初始化（推荐）
在声明内部对象字段时，直接为其赋值一个新实例：

@Data
public class User {
    private String username;
    private Integer age;
    // 定义时直接初始化内部对象
    private UserDetail detail = new UserDetail();
}

此时创建User对象后，detail字段已经是一个可用的UserDetail实例，无需手动赋值：

User user = new User();
user.getDetail().setAddress("北京市朝阳区"); // 安全！

适用场景：内部对象是必选字段，每次创建外部对象时都需要用到。

方案 3：在构造方法中初始化
在外部类的构造方法中，对内部对象进行初始化：

@Data
public class User {
    private String username;
    private Integer age;
    private UserDetail detail;
    
    // 构造方法中初始化
    public User() {
        this.detail = new UserDetail();
    }
}

使用方式和方案 2 一致，创建User时detail已初始化：

User user = new User();
user.getDetail().setAddress("北京市朝阳区"); // 安全！

适用场景：需要在初始化内部对象时做额外逻辑（如传入参数）。

五、扩展：多层嵌套对象的初始化

如果对象结构更复杂（如UserDetail中还有引用类型），初始化逻辑需要 “层层递进”。例如：

@Data
public class Address {
    private String province;
    private String city;
}

@Data
public class UserDetail {
    // 内部再嵌套引用类型
    private Address address = new Address(); // 初始化
}

@Data
public class User {
    private UserDetail detail = new UserDetail(); // 初始化
}

此时操作最内层对象也不会报错：

User user = new User();
user.getDetail().getAddress().setProvince("北京市"); // 安全！

六、总结

1、Java 中，引用类型字段的默认值是null，这是导致空指针的根本原因；
2、Lombok 注解不会自动初始化引用字段，不要依赖它解决初始化问题；
3、初始化内部对象的 3 种方式：手动初始化、定义时初始化、构造方法初始化，根据场景选择即可；
4、多层嵌套对象需要 “层层初始化”，确保每一层都不是null。

掌握这些细节，能帮你减少 80% 以上的空指针异常。你在开发中还有哪些避免空指针的小技巧？欢迎在评论区交流！