Java record pattern 解构嵌套 record 时如何处理 null

把对象改成 record 之后，嵌套解构确实更短，但 null 的边界不能靠直觉判断。User(String name, Address(String city)) 要求嵌套的 Address 对象本身存在；当 address 为 null 时，匹配在这一层失败。若 Address 已存在而它的 city 为 null，内层直接类型模式仍可以接住这个字段。

记住一句话：null 不匹配 record pattern，但 record 里的直接类型模式可以覆盖组件值为 null 的情况。因此要区分“没有 Address”和“Address 有了但 city 为空”，应先匹配外层，再显式判断嵌套对象。

官方地址：https://docs.oracle.com/en/java/javase/21/language/pattern-matching.html

先做一个能看见三层边界的小项目

示例做一个极小的地址标签解析器：用户对象有姓名和地址，地址有城市。我们刻意准备三组输入，分别代表完整地址、嵌套地址不存在、地址存在但城市为空。这样测试的不是“语法能不能写”，而是每一层空值到底改变了哪一个判断。

record Address(String city) {}
record User(String name, Address address) {}

static String nestedPattern(Object value) {
    // 只有 User 和 Address 都能匹配时，才进入这个分支。
    if (value instanceof User(String name, Address(String city))) {
        // Address 已存在；city 可能是 null，所以用 String.valueOf 保留信息。
        return name + "@" + String.valueOf(city);
    }
    // User 存在但 address 为 null 时，会在嵌套 Address pattern 处失败。
    return "未匹配";
}

这里的 String.valueOf(city) 只是让演示输出稳定，不代表业务上应该把空城市显示成字符串。真正关键的是：Address(String city) 这一层的前提是 Address 引用非空。

为什么嵌套 record pattern 会在父组件 null 处失败

Record pattern 的工作方式是先确认待匹配值不是 null，再按组件顺序调用 accessor 并继续匹配。因而下面三种情况不能混为一谈：

所以把“匹配失败”直接翻译成“用户没有地址”并不严谨：第一行甚至没有 User，第二行才是 Address 缺失，第三行是城市字段缺失。

用显式分支把三种输入验收清楚

如果业务需要不同提示，建议把嵌套对象拆开判断。这样写虽然比单行嵌套模式多几行，却把每个失败点都变成可测试的分支：

static String safeLabel(Object value) {
    // 先判断外层类型，避免把普通对象和 null 混入地址逻辑。
    if (!(value instanceof User user)) {
        return "不是用户";
    }
    Address address = user.address();
    // Address 缺失与城市字段为空是两个不同的业务状态。
    if (address == null) {
        return user.name() + ":缺少地址";
    }
    String city = address.city();
    // trim 只用于展示层判断，不修改 record 中保存的原始字段。
    if (city == null || city.isBlank()) {
        return user.name() + ":城市未填写";
    }
    return user.name() + ":" + city;
}

若只想快速提取数据而不关心缺失原因，嵌套 pattern 很合适；若要返回错误码、补默认值或记录监控标签，显式分支更稳。不要用增加括号、改变量名或把 null 强转成空 record 的方式绕过边界。

编译运行后看什么结果

把上面的 record 和两个方法放进 RecordNullDemo.java，再补一个最小入口：

public static void main(String[] args) {
    // 三组样本覆盖外层、嵌套对象和字段三层边界。
    Object[] samples = {
        new User("Lin", new Address("Shanghai")),
        new User("Lin", null),
        new User("Lin", new Address(null))
    };
    for (Object sample : samples) {
        // 同时观察紧凑模式和显式分支的差异。
        System.out.println(nestedPattern(sample) + " | " + safeLabel(sample));
    }
}

# 使用 Java 21 语法编译示例。
javac --release 21 RecordNullDemo.java
# 运行后依次观察完整地址、Address=null、city=null 三种结果。
java RecordNullDemo

验收时重点看三件事：完整地址能返回城市；Address=null 不会误报“城市未填写”；Address(null) 则能进入城市字段分支。变量的作用域也应只出现在模式或显式判断成功之后。

常见问题

嵌套 record pattern 能直接匹配 null 吗？

不能。待匹配的 record 值为 null 时，record pattern 不匹配；嵌套组件为 null 时，对应的嵌套 record pattern 同样不会继续。

为什么 Address(String city) 又能看到 city 为 null？

因为此时 Address 对象已经存在，city 是它的组件值。直接类型模式可以接收这个组件位置的空值，不能据此推断外层嵌套 record 也接收 null。

什么时候应该放弃一行嵌套解构？

当缺失地址、空城市、格式错误需要不同处理，或需要日志和指标时，先匹配 User 再显式检查组件，代码更清楚也更容易写测试。