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

发布时间 - 2026-01-23 00:00:00 点击率：次

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

很多方

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

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

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

正确写法：

private List items = new ArrayList<>(16);

对于 HashMap，按预期键值对数量 × 1.5 设置初始容量，避免多次 rehash
使用 var 时也要确保右侧不是 null：var list = maybeNullList != null ? maybeNullList : new ArrayList();

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

推荐写法：

public void processItems(List items) {
    Objects.requireNonNull(items, "items must not be null");
    // 后续放心遍历
}

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

避免：

for (int i = 0; i < list.size(); i++) {
    String s = list.get(i).trim(); // list 或 list.get(i) 都可能为 null
}

推荐：

for (String s : list) {
    if (s != null) { // 至少保证元素非空再操作
        System.out.println(s.trim());
    }
}

更函数式：

list.stream()
    .filter(Objects::nonNull)
    .map(String::trim)
    .forEach(System.out::println);

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