如何在Java中判断集合是否为空_isEmpty与null检查的规范写法

夏芳小哥_6726

夏芳小哥_6726

2026-03-21

240人浏览

原创

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

如何在java中判断集合是否为空_isempty与null检查的规范写法

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() 返回值判空。

Java Api Extractor
Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

常见错误现象:把 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 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11597

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8702

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7492

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1476

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3049

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20311

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1335

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习