Java中PriorityQueue不允许插入null元素，一旦尝试添加会立即抛出NullPointerException。
Java 中 PriorityQueue 不允许插入 null 元素，一旦尝试添加会立即抛出
NullPointerException</code（NPE），这不是运行时逻辑错误，而是其设计契约的强制约束。</p> <H3>为什么 PriorityQueue 禁止 null？</H3> <p><code>PriorityQueue依赖元素间的自然顺序（实现
Comparable）或自定义比较器进行堆排序。而 null 无法参与比较操作——调用 compareTo() 或比较器的 compare() 方法时必然触发 NPE。JDK 明确在文档和源码中校验并提前拒绝 null，避免后续堆操作（如上浮、下沉）中出现难以定位的空指针。
常见触发场景
- 直接调用
offer(null)、add(null)或poll()后误将返回值（可能为null）再次插入 - 从集合（如
List）批量构造PriorityQueue时，源列表含null - 使用 Stream 聚合或 Optional 链式调用后未判空，将可能为
null的对象加入队列 - 多线程环境下，生产者未校验就放入对象，消费者取到
null后又试图重入队列
如何安全地处理潜在 null
核心原则：在插入前显式过滤或替换 null，而非依赖 try-catch 捕获 NPE（后者掩盖问题且影响性能）。
- 插入单个元素前判空：
if (obj != null) queue.offer(obj); - 构造时过滤 null：
new PriorityQueue(list.stream().filter(Objects::nonNull).collect(Collectors.toList())); - 使用 Optional 包装业务对象，确保下游不传 null；或约定 null 表示“跳过”，不入队
- 若业务需表示“空占位”，可定义专用哨兵对象（如
EMPTY常量），实现合理比较逻辑
调试与定位技巧
当 NPE 报错栈显示在 PriorityQueue.offer() 或构造方法内，直接检查传入值即可。IDE 调试时关注：
立即学习“Java免费学习笔记（深入）”；
- 断点停在插入语句前，观察变量是否为
null - 检查上游数据来源（数据库查询结果、HTTP 响应体、配置项）是否可能返回
null - 使用 Lombok 的
@NonNull或 SpotBugs 注解辅助编译期提示
