Java 21记录模式匹配疑问：含null字段的记录为何匹配并抛NPE？

一、官方文档表述的正确理解 #

官方所说的"null值不匹配任何记录模式"，特指记录实例本身为null的场景，而非记录的字段为null。例如：

Object obj = null;
if (obj instanceof Point(var x, var y)) {
    // 这段代码永远不会执行，因为null不匹配任何记录模式
}

这里的匹配会直接失败，不会进入分支，这才是文档描述的核心场景。

二、非null记录实例（含null字段）匹配成功的原因 #

当你传入一个非null的Point实例（哪怕它的x或y字段是null），instanceof Point(var x, var y)的匹配逻辑分为两步：

1. 先检查目标对象是否为Point类型（或其子类）且非null——这一步会直接通过；
2. 自动调用记录的默认访问器方法（如x()、y()）提取字段值，赋值给变量x和y。

只要实例本身非null，不管字段是否为null，模式匹配都会成功。

三、NullPointerException的来源 #

模式匹配过程本身不会因字段为null抛出NPE，你遇到的异常大概率是在匹配后的代码中直接调用了null字段的非null安全方法导致的。例如：

record Point(Integer x, Integer y) {}

public static void main(String[] args) {
    Point p = new Point(null, 2);
    if (p instanceof Point(var x, var y)) {
        int xVal = x.intValue(); // x为null，调用intValue()触发NPE
    }
}

此时匹配成功，但后续使用null字段的方法时触发了异常，并非匹配过程本身抛出。

如果你的NPE确实在匹配阶段抛出，那大概率是自定义了记录的访问器方法（比如重写x()并加入了可能触发NPE的逻辑），但默认的记录访问器仅返回字段值，不会因字段为null抛出异常。

四、正确处理含null字段的记录模式匹配 #

如果需要避免NPE，可以在匹配逻辑中加入null检查：

// 匹配x非null的Point实例
if (p instanceof Point(Integer x, var y) && x != null) {
    int xVal = x.intValue();
}

// 或在匹配后直接做空安全处理
if (p instanceof Point(var x, var y)) {
    int xVal = Optional.ofNullable(x).map(Integer::intValue).orElse(0);
}

内容的提问来源于stack exchange，提问作者Roberto Eddy Lara Rodríguez