Java集合判空：isEmpty与null检查详解

Java集合判空看似简单，实则暗藏陷阱：直接调用`isEmpty()`会因null引用触发`NullPointerException`，它绝不能替代null检查；正确做法是先确保集合非null（如用`Objects.nonNull()`或显式`!= null`判断），再调用`isEmpty()`，或采用`CollectionUtils.isEmpty()`等null-safe工具方法——尤其在处理MyBatis查询结果、DTO字段或嵌套集合时，混淆“未初始化”与“空集合”将导致线上故障；本文厘清了Collection、Map及视图集合的判空边界，指出过度依赖Optional或滥用`size() == 0`的隐患，并强调：安全、清晰、低侵入的判空逻辑，是每个Java开发者必须掌握的基础防御技能。

Collection.isEmpty() 为什么不能代替 null 检查

直接调用 isEmpty() 在集合变量为 null 时会抛出 NullPointerException，这不是“空集合”，而是“根本没对象”。Java 不做隐式 null 安全，这点和 Kotlin 的 ?.isEmpty() 有本质区别。

常见错误现象：if (list.isEmpty()) 报错 java.lang.NullPointerException: Cannot invoke "java.util.List.isEmpty()" because "list" is null。

• 所有集合接口（Collection、List、Set、Map）的 isEmpty() 都是实例方法，必须在非 null 对象上调用
• Map 虽然不是 Collection 子接口，但也有 isEmpty()，同样不接受 null
• 工具类如 Objects.nonNull() 或 CollectionUtils.isEmpty()（Apache Commons）才是 null-safe 的替代方案

推荐写法：先判 null 再判 isEmpty()

最直白、无依赖、JDK 原生兼容的写法就是显式两步检查。它清晰表达了“我既防空指针，也区分空集合和未初始化”这两层语义。

使用场景：方法入参校验、DTO 字段判空、MyBatis 查询结果处理（比如 selectList() 可能返回 null）。

• 不要写成 list != null && !list.isEmpty() 然后直接用 list —— 如果后续还要遍历，建议提前 return 或 throw，避免嵌套过深
• 若只是判断“有没有元素”，且确定变量不会为 null（例如 Spring Bean 中已初始化的成员变量），可单独用 isEmpty()
• 注意 Optional.ofNullable(list).map(Collection::isEmpty).orElse(true) 是过度设计，增加理解成本且无实际收益

Map.isEmpty() 和 keySet()/values() 的陷阱

Map 的 isEmpty() 行为和 Collection 一致：安全，但只对非 null 的 Map 实例有效。真正容易踩坑的是误用 keySet() 或 values() 返回值判空。

常见错误现象：把 map.get("key") 返回的 value 当作集合，对其调用 isEmpty() —— 实际上这个 value 可能是 null，也可能不是集合类型。

• map.keySet() 和 map.values() 返回的是视图集合（view），它们本身可能为 null 吗？不会 —— 只要 map 非 null，这两个方法一定返回非 null 集合（哪怕 map 为空）
• 但 map.get("x") 返回的是任意类型值，不能假设它是 Collection；强制转型或直接调用 isEmpty() 是运行时风险点
• 如果业务约定 value 是 List，应先用 instanceof 或 Optional 包装，再判空

用 CollectionUtils.isEmpty() 还是自己写工具方法

Apache Commons Collections 的 CollectionUtils.isEmpty() 和 MapUtils.isEmpty() 是 null-safe 的，内部做了 null == collection || collection.isEmpty() 判断。但它引入了第三方依赖，而 JDK 8+ 几乎不需要它。

性能 / 兼容性影响：方法调用开销可忽略，但新增依赖会增加构建体积和版本冲突风险；Android 开发中需注意 commons-collections4 的 API 级别兼容性。

• 若项目已引入 commons-lang 或 commons-collections，直接用 CollectionUtils.isEmpty(list) 更简洁
• 若未引入，不建议仅为这个功能加依赖；可用一行静态方法替代：public static boolean isEmpty(Collection c) { return c == null || c.isEmpty(); }
• 不要用 list.size() == 0 替代 isEmpty() —— 对某些懒加载集合（如 MyBatis 的 LazyLoadList），size() 可能触发查询，而 isEmpty() 更轻量

真正复杂的是嵌套结构：比如 List>>，这时候单层判空远远不够，得结合业务决定“空”的定义——是顶层 null，还是某一层 null，还是所有子集合都为空。这种场景没法靠一个通用方法解决，得拆开逐层看。

今天关于《Java集合判空：isEmpty与null检查详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！