switch pattern null怎么配置或排查

如果 Java 的模式 switch 遇到 null，先记住一个结论：没有显式的 case null 时，选择器为 null 仍会抛出 NullPointerException；要把空值当成一个业务分支处理，应使用 Java 21 及以上的 case null。这不是通过配置文件“打开空值匹配”，而是语法能力、编译版本和分支覆盖共同决定的。

先确认编译器真的在使用 Java 21

很多“语法不支持”的现象并不是代码写错，而是 IDE 使用了 JDK 21，Maven 或 CI 却仍以旧的 --release 编译。Java 21 中，模式匹配 switch 已从预览特性变为正式语言能力；如果项目仍以 17 或更低版本编译，case null、类型模式等写法自然会失败。

public final class SwitchNullDemo {
    public static String classify(Object value) {
        // 用于确认编译器和运行时都允许 Java 21 的模式 switch 语法
        return switch (value) {
            case null -> "空值";
            case String text -> "文本：" + text;
            default -> "其他类型";
        };
    }
}

排查时分别执行 java -version 和 javac -version，再查看构建日志中的 --release。Maven 应检查 maven.compiler.release，Gradle 则检查 Java toolchain 或 options.release。运行时版本较新但编译目标较旧，依旧不能使用这套语法。

null 为什么不会自动落入 Object 模式

case Object obj 看起来能覆盖所有对象，但它不负责吸收空引用。模式匹配先处理选择器的空值语义：没有 case null 时直接抛出 NPE，连后面的 default 也到不了。因此，不能用“看起来足够宽”的类型模式代替空值策略。

这一步还要留意模式支配：更宽的模式写在前面，会让后面的窄模式永远无法命中。例如 case CharSequence text 放在 case String text 前面，后者会被编译器判定为 dominated。先写更具体的类型，再写更宽的类型，能减少这类误判。

按业务意图选择 case null 的写法

如果空值有独立含义，就单独写分支；如果空值和未知类型都走同一套兜底逻辑，可以把它与 default 合并。注意 null 不能和带变量的类型模式放在同一个 case 标签中，因为编译器无法保证模式变量已经初始化。

static String normalize(Object value) {
    // null 是“缺省值”，未知对象是“无法识别”，这里刻意分开处理
    return switch (value) {
        case null -> "未提供";
        case String text when !text.isBlank() -> text.trim();
        case String ignored -> "空文本";
        default -> "不支持的类型";
    };
}

static String fallback(Object value) {
    // 只有 null 和所有未列出的对象都走同一个兜底结果时才合并
    return switch (value) {
        case String text -> text;
        case null, default -> "无可用文本";
    };
}

不要写 case null, String text：这是非法的 case 组合。另一个常见问题是把 default 或无条件类型模式放在前面，导致后续分支被支配。使用箭头规则和表达式返回值，也能避免旧式冒号语法的贯穿风险。

用最小输入矩阵定位“配置或排查”问题

把问题缩小成四个输入，比反复改模式更快：null、非空字符串、空字符串、一个未覆盖的普通对象。预期结果分别对应空值策略、字符串分支、guard 后的空文本分支和 default。若只有 null 失败，优先检查是否遗漏 case null；若整段代码无法编译，优先检查 --release 和 JDK；若出现 dominated，则调整具体模式与宽模式的顺序。

相关问题

Java 17 能不能直接写 case null？

不能按 Java 21 的正式语法直接使用。应升级编译目标，或先在旧版本中显式用 if (value == null) 处理，再进入普通 switch。

有 default 还需要 case null 吗？

需要。default 不会自动接收 null；只有写成 case null, default 才会让两者共享分支。

为什么 Object 模式仍然接不到 null？

模式匹配的空值处理优先于类型匹配。没有 null 标签时，选择器在匹配类型模式前就以 NPE 结束。