Java如何正确判断集合是否包含null值且避免触发空指针异常

首先明确核心逻辑：根据java.util.Collection接口的官方规范，调用contains(null)抛出NullPointerException的唯一约定场景是该集合实现本身不支持存储null元素，此时集合必然不存在null元素，直接符合校验要求。 #

方案1：规范优先的异常捕获实现（推荐） #

该方案严格遵循Collection接口约定，同时兼顾所有集合类型的最优查询性能，只需要提前校验集合本身非空，避免误吞无关NPE：

import java.util.Collection;
import java.util.Objects;

public void doSomething(Collection<?> collection) {
    // 先校验集合本身不为null，避免后续捕获到入参为null导致的NPE
    Objects.requireNonNull(collection, "collection cannot be null");
    
    boolean hasNull;
    try {
        hasNull = collection.contains(null);
    } catch (NullPointerException e) {
        // 符合Collection规范的实现抛出该异常代表不支持null元素，必然无null，直接标记无null
        hasNull = false;
    }
    
    if (hasNull) {
        throw new IllegalArgumentException("collection cannot contain null!");
    }
    
    // 执行业务逻辑
}

该方案的合理性说明：

• 提前校验入参集合本身非空，确保捕获到的NPE只能是contains方法抛出的符合接口约定的场景
• 对HashSet、TreeSet等支持O(1)/O(logn)查询的集合，完全复用其性能优势
• 对Java原生不可变集合等不支持null的实现，捕获异常后直接放行，不会误判
• 若遇到自定义集合实现违反Collection规范抛出无关NPE，属于上游实现的bug，不属于本校验逻辑的覆盖范围

方案2：无异常的类型判断+兜底遍历实现 #

如果完全不想使用异常捕获逻辑，可以通过判断已知支持null的集合类型，优先调用高性能的contains方法，其他类型再兜底遍历，兼顾性能和安全性：

import java.util.*;

public void doSomething(Collection<?> collection) {
    Objects.requireNonNull(collection, "collection cannot be null");
    
    boolean hasNull;
    // 对已知支持null的常用集合类型，直接调用contains
    if (collection instanceof ArrayList || collection instanceof HashSet || collection instanceof LinkedHashSet
            || collection instanceof LinkedList || collection instanceof ArrayDeque) {
        hasNull = collection.contains(null);
    } else {
        // 其他类型兜底遍历判断
        hasNull = false;
        for (Object e : collection) {
            if (e == null) {
                hasNull = true;
                break;
            }
        }
    }
    
    if (hasNull) {
        throw new IllegalArgumentException("collection cannot contain null!");
    }
    
    // 执行业务逻辑
}

该方案的特点：

• 无异常捕获逻辑，完全避免吞异常的风险
• 覆盖绝大多数常用的高性能集合类型，不会浪费其查询性能优势
• 小众自定义集合类型会走遍历兜底，正确性不受影响

方案3：极简遍历实现（性能要求不高的场景） #

如果集合规模普遍不大，不需要极致性能，可以直接用增强for或者Stream遍历，代码极简且无任何兼容问题：

// 增强for实现
public void doSomething(Collection<?> collection) {
    Objects.requireNonNull(collection);
    for (Object e : collection) {
        if (e == null) throw new IllegalArgumentException("collection cannot contain null!");
    }
    // 业务逻辑
}

// Stream实现（Java 8+）
public void doSomething(Collection<?> collection) {
    Objects.requireNonNull(collection);
    if (collection.stream().anyMatch(Objects::isNull)) {
        throw new IllegalArgumentException("collection cannot contain null!");
    }
    // 业务逻辑
}

内容的提问来源于stack exchange，提问作者Hoopje