在Java里如何避免集合的空指针问题_Java集合安全使用解析

夜萱姑娘_1247

夜萱姑娘_1247

2026-01-23

1054人浏览

原创

应使用 Collections.emptyList() 等不可变空集合替代 null 返回值,避免 NPE;初始化集合时指定容量减少扩容;入参用 Objects.requireNonNull() 提前校验;遍历优先用增强 for 或 stream。

在java里如何避免集合的空指针问题_java集合安全使用解析

用 Collections.emptyList() 替代 null 返回集合

很多方法习惯返回 null 表示“没有数据”,但调用方一不注意就触发 NullPointerException。Java 标准库提供了不可变空集合,直接复用比新建更安全高效。

  • Collections.emptyList()、Collections.emptySet()、Collections.emptyMap() 都是线程安全的单例,零内存开销
  • 避免写 return null;,改用 return Collections.emptyList();
  • 调用方无需判空即可调用 .size()、.isEmpty()、.stream() 等方法
  • 如果后续需要添加元素,必须显式转为可变集合(如 new ArrayList(list)),否则抛 UnsupportedOperationException

初始化时用 ArrayList 或 HashMap 的带容量构造器

默认无参构造器在首次 add() 或 put() 时才分配底层数组,但若已知大致数量,提前指定容量能减少扩容次数,也避免因忘记初始化导致的 NullPointerException(比如误把未初始化的字段当集合用)。

  • 错误写法:
    private List<string> items;</string>
    —— 字段未初始化,为 null
  • 正确写法:
    private List<string> items = new ArrayList(16);</string>
  • 对于 HashMap,按预期键值对数量 × 1.5 设置初始容量,避免多次 rehash
  • 使用 var 时也要确保右侧不是 null:var list = maybeNullList != null ? maybeNullList : new ArrayList();

用 Objects.requireNonNull() 在入口校验入参集合

方法接收集合参数时,不建议在内部反复判空,而应在最开始明确拒绝 null,让问题暴露得早、堆栈清晰。

Java Development Man
Java Development Man

Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。

下载
  • 替代手写 if (list == null) throw new IllegalArgumentException(...)
  • 推荐写法:
    public void processItems(List<string> items) {
        Objects.requireNonNull(items, "items must not be null");
        // 后续放心遍历
    }</string>
  • 若允许空集合但不允许 null,就不用额外处理;若业务上空集合也非法,再加 !items.isEmpty() 校验
  • 注意:该方法只校验 null,不校验集合内元素是否为 null

遍历时优先用增强 for 或 stream(),别手动操作 iterator 或下标

手动管理索引或迭代器容易越界或漏判空,尤其在嵌套结构中。现代 Java 写法天然规避部分风险。

  • 避免:
    for (int i = 0; i 
  • 推荐:
    for (String s : list) {
        if (s != null) { // 至少保证元素非空再操作
            System.out.println(s.trim());
        }
    }
  • 更函数式:
    list.stream()
        .filter(Objects::nonNull)
        .map(String::trim)
        .forEach(System.out::println);
  • 注意:stream() 对 null 集合本身仍会抛异常,所以需前置判空或用上面提到的空集合兜底

实际项目里最常被忽略的是字段初始化和返回值约定——不是所有团队都统一用 emptyList(),也不是所有 API 文档都明确写清“不返回 null”。只要有一个环节松动,空指针就会在深夜测试环境突然冒出来。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

569

3

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

2024.03.01

1698

6

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

2026.04.23

399

31

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

7067

5

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.10

2908

6

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

7067

5

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.10

2908

6

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

2023.08.10

4898

6

空指针异常处理
空指针异常处理

本专题整合了空指针异常解决方法,阅读专题下面的文章了解更多详细内容。

2025.11.16

179

10

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习