Java 正则陷阱：为什么 matcher.find() 第二次调用总是返回 false

今天在处理字符串正则匹配时，我遇到了一个非常隐蔽的 Bug。代码逻辑看起来完全正确，但运行结果却出乎意料：明明字符串里有匹配项，程序却提示“未找到”。

经过排查，我发现罪魁祸首竟然是我对 java.util.regex.Matcher 中 find() 方法的误解。这里记录下这个陷阱，避免自己（以及看到这篇文章的你）再次踩坑。

1. 问题复现

我的需求很简单：从一段文本中提取邮箱地址，并在提取前打印一条日志确认是否匹配成功。

String text = "Contact us at support@example.com";
Pattern pattern = Pattern.compile("[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}");
Matcher matcher = pattern.matcher(text);

// 第一步：我想先看看有没有匹配，打个日志
if (matcher.find()) {
    System.out.println("Log: Found match -> " + matcher.group());
}

// 第二步：正式业务逻辑，处理匹配项
if (matcher.find()) {
    System.out.println("Process: " + matcher.group());
} else {
    System.out.println("Error: No match found in business logic!");
}

我预期的输出：

Log: Found match -> support@example.com
Process: support@example.com

实际的输出：

Log: Found match -> support@example.com
Error: No match found in business logic!

我很困惑：为什么第一步明明找到了，第二步却说没找到？

2. 核心原因：我误以为 find() 是无状态的

我一直潜意识里认为 matcher.find() 像一个纯函数查询：“告诉我字符串里有没有匹配项？”每次调用它都应该从头开始扫描。

但实际上，Matcher是一个有状态的对象find()是一个迭代操作

当我第一次调用 matcher.find() 时：

1. 它从索引 0 开始搜索，找到了 support@example.com。
2. 关键步骤：它将内部指针（Cursor）移动到了匹配项结束的位置（即字符串末尾）。
3. 返回 true。

当我第二次调用 matcher.find() 时：

1. 它不会从头开始，而是从上一次匹配结束后的下一个位置继续搜索。
2. 因为指针已经在字符串末尾，后面没有内容了。
3. 返回 false。

这就是为什么我的业务逻辑拿不到数据的原因：第一次调用为了打日志，“消耗”掉了唯一的匹配项。

此外，如果我混合使用 matches() 和 find()，情况会更复杂，因为 matches() 也会改变内部状态变量（如 last 和 oldLast），导致后续行为不可预测 。

3. 我是如何修复的

意识到 find() 的“迭代器”本质后，我采用了以下两种修复方案。

方案一：只调用一次 find()，复用结果（推荐）

我不再为了“检查存在性”而单独调用 find()。既然 find() 返回 true 时已经定位到了匹配项，我应该直接提取数据，然后在内存中复用这个数据。

Matcher matcher = pattern.matcher(text);

// ✅ 正确做法：一次查找，多次使用
if (matcher.find()) {
    String email = matcher.group(); // 先提取出来
    
    // 日志使用提取的变量
    System.out.println("Log: Found match -> " + email);
    
    // 业务逻辑也使用提取的变量
    processEmail(email);
}

这样既避免了重复扫描，也保证了指针状态不会干扰后续逻辑。

方案二：使用 reset() 重置状态

如果我的逻辑确实需要分阶段独立判断（例如先校验格式，再提取内容），我必须在中间重置 Matcher 的状态。

Matcher matcher = pattern.matcher(text);

// 第一阶段：校验
if (matcher.find()) {
    System.out.println("Log: Valid format");
}

// ✅ 关键：重置指针到起始位置
matcher.reset(); 

// 第二阶段：正式提取
if (matcher.find()) {
    System.out.println("Process: " + matcher.group());
}

matcher.reset() 会将内部指针复位到 0，确保下一次 find() 从头开始搜索 。

4. 总结与反思

这次踩坑让我深刻认识到：

1. Matcher.find()不是查询，是遍历：把它想象成 Iterator.next()，每调用一次，指针就向前移动。
2. 警惕副作用：在调试或日志打印中调用 find()、matches() 等方法，会改变对象状态，直接影响后续业务逻辑。
3. 最佳实践：
   • 尽量在一次 find() 调用中提取所有需要的数据（通过 group()）。
   • 避免对同一个 Matcher 实例进行多次独立的“存在性检查”。
   • 如果必须重新匹配，显式调用 reset()。

希望这篇记录能帮我在未来写出更健壮的正则处理代码。如果你也遇到过类似的问题，欢迎交流！