17370845950

Java NullPointerException如何避免_Java空指针异常预防要点解析
空指针异常应以预防为主,而非捕获:用Optional封装返回值、启用@NonNull/@Nullable注解、统一判空工具、构造器注入确保依赖不为空,并在单元测试中模拟null场景。

空指针异常(NullPointerException)是 Java 开发中最常见、最易触发的运行时异常之一。它不编译报错,却常在上线后突然爆发,导致服务中断或数据异常。避免它的核心不是“捕获”,而是“预防”——从编码习惯、工具支持和设计思路上提前堵住空值入口。

用 Optional 明确表达可能为空的返回值

方法返回 null 往往是为了表示“找不到”或“无结果”,但这把判断责任完全推给调用方,极易遗漏。改用 Optional 能强制调用方处理空场景:

  • 方法内部用 Optional.ofNullable(result) 包装可能为 null 的返回值
  • 调用方必须显式调用 .isPresent().orElse().ifPresent(),无法直接 .get() 而不检查
  • 注意:不要把 Optional 用作字段类型或参数类型,仅用于返回值

启用并信任 @NonNull / @Nullable 注解

借助 IDE(如 IntelliJ)和编译器插件(如 Checker Framework 或 Lombok 的 @NonNull),可在编译期发现潜在空指针风险:

  • 在参数、字段、返回值上标注 @NonNull,IDE 会提示未判空就直接使用的代码
  • Lombok 的 @RequiredArgsConstructor 配合 @NonNull 字段,会在构造时自动插入非空校验
  • Spring Boot 2.5+ 默认启用 spring-boot-configuration-processor,对配置类属性也支持非空提示

集合与字符串操作前先判空再判内容

很多人只记得判 list != null,却忘了 list.isEmpty();只判 str != null,却直接调 str.trim().length() —— 中间任意一环都可能炸:

  • 统一用 Objects.requireNonNull(obj, "xxx 不能为空") 在入口快速失败,比静默 NPE 更易定位
  • 字符串判空用 StringUtils.isBlank(str)(Apache Commons)或 String.valueOf(str).trim().isEmpty(),避免 null 调用
  • 集合操作前优先用 CollectionUtils.isNotEmpty(coll),而非手写 coll != null && !coll.isEmpty()

依赖注入与构造器初始化要“即用即检”

Spring 管理的 Bean 若存在循环依赖或配置遗漏,可能导致字段为 null;手动 new 的对象若忘记赋值,也会埋雷:

  • 优先使用构造器注入(@AllArgsConstructor(onConstructor_ = @__({@Autowired}))),让容器在创建时就确保依赖不为空
  • 避免在 @PostConstruct 方法中才去校验字段,应把校验逻辑提前到构造器或 setter 中
  • 单元测试里主动模拟 null 依赖(如 Mockito 的 @MockBean 未初始化场景),验证是否抛出明确异常而非 NPE

基本上就这些。空指针不是靠 try-catch 拦住的,而是靠每一步都默认“它可能为空”,再用工具、约定和一点点防御性思维把它挡在执行之前。