如何解决Java方法中访问对象时出现的NullPointerException错误？

Java里的NullPointerException（简称NPE），本质就是你试图操作一个null对象——比如调用它的方法、访问它的字段，甚至把null当数组用，都会触发这个异常。下面直接说排查思路、常见场景的解决办法，以及预防手段：

一、先快速定位问题代码 #

异常日志里会明确标出抛出NPE的行号，直接去那行找：哪一个对象在被调用方法/访问属性？这个对象就是大概率为null的那个。
比如看到这行代码抛NPE：String username = user.getUsername();，不用多想，先查user是不是null。

二、常见场景及解决办法 #

1. 对象没初始化就直接用 #

比如写了User user;但没给它赋值，Java里引用类型默认是null，这时候调用user.getXXX()必炸。
解决：要么提前实例化：User user = new User();，要么确保从其他地方（比如数据库查询、接口返回）拿到的对象不是null——比如查数据库后加个判断：

User user = userDao.findById(1L);
if (user != null) {
    // 再调用user的方法
}

2. 方法返回null，直接链式调用 #

比如String content = getContentFromApi().trim();，如果getContentFromApi()返回null，trim()直接抛NPE。
解决：先把返回值存下来，判断非null再操作：

String temp = getContentFromApi();
String content = temp != null ? temp.trim() : "";

3. 集合/数组里混了null元素 #

遍历数组或集合时，某个元素是null，调用它的方法就会炸：

List<User> userList = Arrays.asList(new User(), null);
for (User u : userList) {
    System.out.println(u.getName()); // 第二个元素是null，直接抛NPE
}

解决：遍历的时候加个null判断：

for (User u : userList) {
    if (u != null) {
        System.out.println(u.getName());
    }
}

4. 包装类自动拆箱时的null #

比如Integer age = null; int realAge = age;，这里自动把Integer转成int时，因为age是null，直接抛NPE。
解决：确保包装类对象非null，或者用Optional处理：

Integer age = getAge();
int realAge = age != null ? age : 0;
// 或者用Optional
int realAge = Optional.ofNullable(age).orElse(0);

三、日常预防手段 #

• 用Optional类处理可能为null的对象，避免到处写null判断：

  Optional<User> optionalUser = Optional.ofNullable(user);
  optionalUser.ifPresent(u -> System.out.println(u.getName()));
  // 或者获取默认值
  String username = optionalUser.map(User::getUsername).orElse("匿名");
  

• 初始化时给默认值：比如集合直接初始化为new ArrayList<>()，而不是留着null；字符串初始化为""而非null。
• 用@NonNull注解（比如Spring的@NonNull、JSR305的@Nonnull），让IDE提前提示你可能传入null的地方，在编译阶段就规避问题。
• 写单元测试时，专门覆盖null场景：比如传null参数、返回null的方法，提前发现潜在的NPE。

内容的提问来源于stack exchange，提问作者William