findFirst() 返回 Optional，需用 isPresent() 或 orElse() 等安全解包；filter 必须在 findFirst() 前，否则逻辑错误；并行流中不保证原始顺序，强序需求应改用串行流或 findAny()。
findFirst() 返回的是 Optional，不是直接的元素
调用 Stream.findFirst() 永远返回 Optional<t></t>，哪怕流非空且有匹配项。直接调用 .get() 在无结果时会抛 NoSuchElementException，这是最常见误用点。
- 必须先检查是否有值：用
.isPresent()或更安全的.orElse(null)/.orElseGet(() -> ...) - 如果业务上“找不到就报错”，才用
.orElseThrow(() -> new RuntimeException("...")) - 别在日志或调试中只写
System.out.println(stream.findFirst())——输出的是Optional[xxx]，容易误判逻辑是否命中
filter() 必须放在 findFirst() 前面，顺序不能颠倒
findFirst() 本身不接受谓词，它只取当前流头部元素；要找“满足条件的第一个”，必须先用 filter() 筛一遍，再调 findFirst()。顺序写反（比如先 findFirst() 再 filter()）会导致编译失败或逻辑错误。
- 正确写法：
list.stream().filter(x -> x.getStatus() == ACTIVE).findFirst() - 错误写法：
list.stream().findFirst().filter(...)—— 这里findFirst()返回Optional，后续filter()是对 Optional 操作，不是对流 - 注意短路行为：
filter().findFirst()是惰性求值，遇到第一个匹配就停止，不会遍历整个集合
并行流下 findFirst() 不保证“第一个”的原始顺序
在 parallelStream() 中调用 findFirst()，结果仍是“满足条件的第一个”，但这个“第一个”是按并行分段处理后、各段最先匹配到的元素中**任意一个**，不保证是原集合索引最小的那个。
- 若需严格按原始顺序取首个匹配项，必须用
stream()（非并行），或改用findAny()并接受不确定性 -
findAny()在并行流中性能更好，但语义不同：它只承诺返回“某个匹配项”，不强调“第一个” - 没有“并行流 + 严格序号首个”的内置捷径；真有强顺序需求，要么转回串行流，要么手动加索引字段再排序取 limit(1)
空集合、null 元素、提前终止场景要单独验证
findFirst() 对空流返回 Optional.empty()，但它不校验流中元素是否为 null。如果 filter 条件里有 .equals() 或方法调用，而流中含 null，可能触发 NullPointerException。
- 安全写法示例：
list.stream().filter(Objects::nonNull).filter(x -> "OK".equals(x.getCode())).findFirst() - 注意中间操作可能被优化掉：比如
Stream.of(null).filter(Objects::nonNull).findFirst()返回empty，但Stream.of(null).findFirst()返回Optional.ofNullable(null) - 若流来自数据库分页查询（如 MyBatis 的
Stream<t></t>返回值），确保连接未关闭、游标有效，否则findFirst()可能抛SQLException而非返回 empty
