java空指针怎么避免

在 Java 中，**空指针异常（NullPointerException，NPE）**是最常见的运行时异常之一。避免空指针，核心思路是：不让变量为 null，或在使用前确认不为 null。下面从「编码习惯、语法特性、工具与框架」几个层面系统说明。

一、基础编码习惯（最重要）

1. 初始化对象，避免 null

List<String> list = new ArrayList<>();
// 而不是
List<String> list = null;

2. 方法尽量不要返回 null

用“空对象”代替 null：

// 不推荐
public List<User> getUsers() {
    return null;
}

// 推荐
public List<User> getUsers() {
    return Collections.emptyList();
}

3. 调用方法前做判空（传统方式）

if (user != null && user.getName() != null) {
    System.out.println(user.getName());
}

二、使用 Java 8+ 提供的工具（强烈推荐）

4. Optional（最推荐）

Optional 明确表达“可能为空”。

Optional<User> userOpt = getUser();
userOpt.ifPresent(u -> System.out.println(u.getName()));

避免这样用（反而更复杂）：

if (userOpt.isPresent()) {
    User u = userOpt.get(); // 不如 ifPresent
}

链式安全获取：

String name = Optional.ofNullable(user)
                      .map(User::getName)
                      .orElse("未知");

5. 使用 Objects.requireNonNull

在方法参数入口尽早失败：

public void setUser(User user) {
    this.user = Objects.requireNonNull(user, "user 不能为 null");
}

三、利用语言与工具特性

6. 使用 String.isEmpty() 替代 == null

if (str != null && !str.isEmpty()) { }

Java 11+：

if (str != null && !str.isBlank()) { }

7. 使用注解明确语义

import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

public void process(@NotNull User user) { }

配合 IDE（IntelliJ IDEA）可编译前提示 NPE 风险。

8. 使用 Lombok（减少样板代码）

@NonNull
private String name;

自动生成 null 检查。

四、集合与数组注意点

9. 集合判空规范

if (list != null && !list.isEmpty()) { }

工具类推荐：

• CollectionUtils.isEmpty(list)（Apache / Spring）
• MapUtils、StringUtils

10. 避免使用 null 作为数组元素

String[] arr = new String[3];
// arr[0] 默认就是 null

遍历时：

for (String s : arr) {
    if (s != null) { }
}

五、设计层面避免 NPE

11. 使用空对象模式（Null Object）

interface Logger {
    void log(String msg);
}

class NullLogger implements Logger {
    public void log(String msg) { }
}

12. 尽早失败（Fail Fast）

不要在深层代码中才发现 null，应在入口校验。

六、调试与检测工具

• IDE 警告（IntelliJ / Eclipse）
• SpotBugs / FindBugs
• SonarLint
• JUnit 测试覆盖 null 场景

总结一句话

能不返回 null 就不返回，返回了就用 Optional 或判空，调用前确认安全。

如果你愿意，我可以：

• 给你一套 Java 空指针检查清单
• 或结合你具体代码场景帮你改造成防 NPE 写法