Java中最易触发NullPointerException的场景包括：未检查null就调用方法或访问字段；Map.get()后直接链式调用；构造函数中未校验参数null；误用Optional.of()而非ofNullable()；未合理使用@NonNull/@Nullable注解；Stream操作未过滤null元素；Collection判空前未检查引用本身；以及防御性拷贝缺失导致外部修改影响内部状态。
Java中哪些地方最容易触发NullPointerException
绝大多数 NullPointerException 不是“突然发生”的，而是源于对引用未做空值检查就直接调用方法或访问字段。最典型的是从外部接收参数、调用第三方接口返回值、或使用 Map.get() 后直接链式调用。
-
Map.get()返回null时，立刻接.toString()或.length()—— 这是最高频的空指针来源 - 构造函数里把参数赋给成员变量，但没校验是否为
null，后续任意一次方法调用都可能崩 - 使用
Optional.of()包装可能为null的值 —— 错！Optional.of(null)会立即抛NullPointerException，该用Optional.ofNullable()
如何用@NonNull和@Nullable让IDE和编译器提前报警
注解本身不运行，但配合 Lombok 或 IntelliJ/Android Studio 的静态分析，能在写代码时就标出潜在空指针路径。关键不是“加了注解就安全”，而是让工具链把空值流暴露出来。
- 在方法参数、返回值、字段上加
@NonNull（如 JetBrains 的org.jetbrains.annotations.NotNull），IDE 会在传入null时标黄警告 -
@Nullable要配对使用：如果一个方法声明返回@Nullable String，调用方就必须在使用前判空，否则 IDE 会提示“May produce ‘NullPointerException’” - 注意 Lombok 的
@RequiredArgsConstructor不会自动为@NonNull参数生成空检查 —— 得手动加@NonNull字段 +@AllArgsConstructor(onConstructor_ = @NonNull)才生效
Collection和Stream操作中的防御性陷阱
很多人以为用了 Stream 就天然防空，其实不然。空集合能过，空元素照样崩；Collectors.toList() 不拒绝 null 元素，但后续遍历时一碰就炸。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
list.stream().filter(Objects::nonNull).map(String::length)—— 必须显式过滤，不能依赖上游“应该不给 null” -
Arrays.asList(null)是合法的，但stream().map(...)里若没判空，第一个元素就 NPE -
Collection.isEmpty()比collection == null || collection.size() == 0安全，但前提是 collection 本身不为null—— 所以得先判引用再判内容
构造函数和setter里的防御性拷贝怎么做才不白忙
防御性编程不是“所有参数都 new 一遍”，而是识别哪些对象可变、哪些会被外部持有引用。String 和基本类型包装类是不可变的，不用拷贝；ArrayList、Calendar、自定义 POJO 就必须深拷贝或不可变封装。
- 接收
List参数时，用new ArrayList(param)拷贝，避免外部后续修改影响内部状态 - 不要用
Collections.unmodifiableList()替代拷贝 —— 它只防止修改视图，原列表仍可能被他人改 - 对于含嵌套对象的 DTO，
clone()很容易漏层级，建议用构造函数逐字段复制，或用 Jackson 的ObjectMapper.readValue(json, type)做序列化级隔离
真正难的不是写几个 if (x == null)，而是判断“这个引用到底有没有可能被别人改”——它决定了你要防御的是空值，还是可变性，还是两者都要。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
