NullPointerException 是 Java 开发中出现频率最高、最隐蔽、最容易被轻视的运行时异常。线上 80% 的接口崩溃、逻辑报错、异常堆栈，根源几乎都是简单的空指针处理不当。
在解决问题前，必须先理解问题。本节从 Java 类型系统与 JVM 运行机制层面，剖析 null 与 NPE 的本质。
Java 数据类型分为基本类型与引用类型，二者对空值的支持完全不同，也是 NPE 只出现在引用类型的核心原因：
编译阶段 JVM 不会校验空引用，只有在运行阶段，对 null 引用执行对象操作时，会直接抛出 NullPointerException。以下是 100% 触发 NPE 的核心操作：
本节汇总项目中所有高频 NPE 场景，每个场景均提供：错误代码 + 报错原因 + 传统修复方式，为后续 Optional 优雅重构做铺垫。
String name = null;
// 空对象调用实例方法，直接抛出 NPE
System.out.println(name.length());if (name != null) {
System.out.println(name.length());
}Integer age = null;
// 底层隐式执行：age.intValue()，null调用方法直接报错
int userAge = age;String[] arr = null;
// 数组引用为空，获取长度、取值均会 NPE
System.out.println(arr.length);
System.out.println(arr[0]);// 模拟DAO查询无数据返回null
List<User> userList = userDao.queryUserList();
// null集合调用forEach，直接NPE
userList.forEach(System.out::println);// 用户-地址-城市 多层嵌套取值
User user = null;
// 任意一层为空，直接NPE
String city = user.getAddress().getCity().getName();String city = null;
if (user != null) {
Address address = user.getAddress();
if (address != null) {
City cityObj = address.getCity();
if (cityObj != null) {
city = cityObj.getName();
}
}
}public void printUserName(User user){
// 调用方传入null直接报错
System.out.println(user.getName());
}Map<String, String> map = new HashMap<>();
// key不存在，返回null
String value = map.get("name");
// null调用方法，NPE
value.trim();// 远程调用空结果
String result = remoteApi.getData();
// null调用大写转换，直接报错
System.out.println(result.toUpperCase());Object lock = null;
// 锁对象为null，直接NPE
synchronized (lock){
// 业务逻辑
}绝大多数开发者依赖的 if (obj != null) 判空，看似稳妥，实则存在无法规避的硬伤，也是行业逐步弃用的原因。
if 判空，统一使用 Optional 实现优雅空值处理。
Optional 是 JDK8 专为解决 NPE 设计的空值安全容器工具类。它不存储业务数据，仅对业务对象进行包装，将「主动判空」转为「容器安全处理」，从语法层面彻底杜绝空指针。
// 正常非空创建
Optional<String> op1 = Optional.of("Java");
// 传入null，直接报错
Optional<String> op2 = Optional.of(null);// 包装非空数据
Optional<String> op1 = Optional.ofNullable("Java");
// 安全包装null值
Optional<String> op2 = Optional.ofNullable(null);Optional<String> emptyOp = Optional.empty();get()，空值会直接报错，失去 Optional 意义。String str = null;
Optional<String> op = Optional.ofNullable(str);
String res1 = op.orElse("默认字符串");String res2 = op.orElseGet(
() -> "懒加载默认值"
);String res3 = op.orElseThrow(
() -> new RuntimeException("数据不能为空")
);Optional<String> op = Optional.ofNullable(str);
if (op.isPresent()) {
System.out.println(op.get());
}Optional<String> op = Optional.ofNullable("博客园技术博客");
op.ifPresent(System.out::println);User user = new User("张三", 20);
// 安全提取用户名，无需手动判空
String userName = Optional.ofNullable(user)
.map(User::getName)
.orElse("未知用户");int age = Optional.ofNullable(user)
.map(User::getAge)
.filter(a -> a > 18)
.orElse(0);针对前文 9 大高频 NPE 场景，全部重构为企业级 Optional 优雅写法，可直接项目落地。
彻底消灭 if 嵌套，一行代码完成多层安全取值，任意层为空均安全兜底。
String city = null;
if (user != null) {
Address address = user.getAddress();
if (address != null) {
City cityObj = address.getCity();
if (cityObj != null) {
city = cityObj.getName();
}
}
}String cityName = Optional.ofNullable(user)
.map(User::getAddress)
.map(Address::getCity)
.map(City::getName)
.orElse("未知城市");List<User> userList = userDao.queryUserList();
// null集合兜底为空集合，安全遍历无报错
List<User> safeList = Optional.ofNullable(userList)
.orElse(Collections.emptyList());
safeList.forEach(System.out::println);Integer age = null;
// 空值安全兜底，杜绝拆箱NPE
int safeAge = Optional.ofNullable(age).orElse(0);Map<String, String> map = new HashMap<>();
// Key不存在返回空字符串，规避NPE
String value = Optional.ofNullable(map.get("name"))
.orElse("");String result = remoteApi.getData();
// 远程空值兜底，保障后续逻辑安全
String safeResult = Optional.ofNullable(result)
.orElse("");Optional<Optional<T>> 冗余嵌套// 无论user是否为空，都会new User()，冗余创建对象
User user = Optional.ofNullable(getUser())
.orElse(new User());User user = Optional.ofNullable(getUser())
.orElseGet(User::new);| 对比维度 | orElse(T) | orElseGet(Supplier) |
|---|---|---|
| 默认值创建时机 | 无论是否为空都创建 | 仅为空时才创建 |
| 性能表现 | 有冗余对象创建开销 | 最优，无浪费 |
| 适用场景 | 固定常量、字符串字面量 | new 对象、DB 查询、远程调用 |
| 推荐指数 | ★★☆☆☆ | ★★★★★ |
将本文核心要点浓缩为四句口诀，记忆这四句话，便可在日常开发中彻底告别 99% 的 NPE 烦恼。