Java中Pattern.matcher(null)抛出NPE：@NotNull相关技术疑问

问题场景 #

以下代码运行时抛出异常：

Pattern pattern = Pattern.compile("");
Matcher matcher = pattern.matcher(null);

捕获的异常信息：

Uncaught exception: java.lang.NullPointerException: Cannot invoke "java.lang.CharSequence.length()" because "this.text" is null at java.base/java.util.regex.Matcher.getTextLength(Matcher.java:1769) at java.base/java.util.regex.Matcher.reset(Matcher.java:415) at java.base/java.util.regex.Matcher.(Matcher.java:252) at java.base/java.util.regex.Pattern.matcher(Pattern.java:1134)

IDE显示pattern.matcher()方法标记了@NotNull注解，推测是类路径上的NotNull验证器触发异常，针对相关疑问解答如下：

1. @NotNull注解来自何处？是否属于Java SDK？ #

@NotNull不属于Java标准SDK，它是第三方代码规范或验证框架提供的注解，常见来源包括：

• JetBrains IntelliJ IDEA自带的org.jetbrains.annotations.NotNull（这也是IDE显示该注解的最常见原因）
• Jakarta Validation（原Java EE Validation）规范中的javax.validation.constraints.NotNull或jakarta.validation.constraints.NotNull
• Google Guava、FindBugs等代码质量工具提供的同功能注解

Java官方文档里找不到这个注解，因为它并非Java核心API的组成部分。

2. 如何确定是哪个验证器抛出的该异常？ #

从你提供的异常栈来看，当前的NPE是JDK核心代码直接触发的，并非第三方验证器抛出——异常栈的所有调用链路都属于java.base模块下的JDK正则类库。

如果要排查是否存在第三方验证器介入，可以做这些操作：

• 检查项目依赖列表，确认是否引入了Jakarta Validation、Spring Validation等带注解验证的库
• 启动程序时添加JVM参数-verbose:class，查看加载的@NotNull注解类的全限定名，确定其所属库
• 在IDE中点击@NotNull注解，直接跳转查看它的包路径，就能明确来源

3. 若不是验证器导致，为何会抛出方法签名中未声明的异常？ #

因为NullPointerException属于运行时异常（RuntimeException），Java语法规定这类异常不需要在方法签名里用throws声明。

具体到这个场景：当你给matcher()传入null后，JDK内部的Matcher构造函数会调用reset()方法，进而尝试获取传入文本的length()，此时文本为null，直接触发NPE。这是JDK在运行时的参数校验逻辑，和编译时的注解验证无关。

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