Collection.isEmpty() 不能代替 null 检查,因 null 调用会抛 NullPointerException;必须先判 null 再调用 isEmpty(),或使用 Objects.nonNull()、CollectionUtils.isEmpty() 等 null-safe 方案。

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免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











