Java集合判空技巧实用指南

本文深入剖析了Java集合判空的正确姿势与常见误区，强调应优先使用语义清晰、性能稳定且契约明确的`collection.isEmpty()`而非`size() == 0`或直接`== null`判断；明确区分“集合为null”与“集合为空”的本质差异，指出盲目依赖`== null`不仅逻辑错误，还易引发NPE，而未处理null就调用`isEmpty()`同样危险；结合Java原生工具（如`Objects.requireNonNullElse`）、Spring `CollectionUtils.isNotEmpty()`及防御式编程实践，提供兼顾安全性、可读性与工程鲁棒性的判空方案，并呼吁将空值校验前移至参数验证层，从源头规避问题——掌握这些技巧，能让代码更健壮、更易维护、更少踩坑。

Java 中判断集合是否为空，优先用 collection.isEmpty()，而不是 collection.size() == 0 或 collection == null 直接判空。 后者要么有 NPE 风险，要么低效或语义不准确。

为什么不能直接用 collection == null 判空

很多开发者误以为“集合为空”等于“集合变量为 null”，但这是两个完全不同的概念：null 表示引用未指向任何对象；而空集合（如 new ArrayList()）是一个真实存在的、长度为 0 的对象。

• null 调用 isEmpty() 或 size() 会抛出 NullPointerException
• 业务中返回 null 通常是设计缺陷，应尽量用空集合替代（符合“空对象模式”）
• 若 API 确实可能返回 null（如某些老旧 DAO 方法），必须先判 null，再判 isEmpty()

isEmpty() 比 size() == 0 更安全高效

Collection 接口明确要求 isEmpty() 时间复杂度为 O(1)，且语义更清晰；而 size() 在部分实现中（如某些懒加载的 Hibernate 集合代理、LinkedList）虽通常也是 O(1)，但存在例外，且多一次方法调用和数值比较。

• isEmpty() 是专为判空设计的契约方法，可读性与意图表达更强
• 某些特殊集合（如 Guava 的 ImmutableList）对 isEmpty() 做了额外优化
• 静态分析工具（如 SonarQube）会警告 size() == 0 作为判空条件

常见集合类型的实际判空写法

以下写法覆盖大多数场景，兼顾 null 安全与语义正确：

if (list != null && !list.isEmpty()) {
    // list 非 null 且非空
}

// 使用 Objects.requireNonNullElse（Java 9+）或 Optional（更函数式）
List safeList = Objects.requireNonNullElse(inputList, Collections.emptyList());
if (!safeList.isEmpty()) {
    // 安全使用
}

// Spring Framework 提供的工具类（若项目已引入）
if (CollectionUtils.isNotEmpty(list)) { // 内部已处理 null
    // ...
}

• 永远不要单独依赖 list != null 或 list.size() > 0
• CollectionUtils.isNotEmpty() 是最省心的选择（但需确认项目已依赖 Spring Core）
• 流式操作前务必确保集合非 null，否则 list.stream() 会 NPE

最容易被忽略的是：判空逻辑常出现在 if 条件末尾或日志打印前，此时若上游传入 null，问题会延迟暴露。把判空提前到参数校验层（如 Controller 入参用 @NotNull + Hibernate Validator），比在业务逻辑里反复防御更治本。

本篇关于《Java集合判空技巧实用指南》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！