用途：在 Java 代码中识别并应用函数式异常处理最佳实践，减少异常滥用，改用单子错误类型，以提升错误表达的清晰度、可维护性与性能。
主要能力：用 Optional<T> 处理可空值，替代抛出 NullPointerException 或 NotFoundException；用 VAVR Either<L,R> 表达可预期的业务逻辑失败；用 CompletableFuture<T> 处理异步错误；用密封类与 record 构建丰富的错误类型层级并支持穷尽模式匹配；用枚举错误类型处理简单失败场景；通过 flatMap/map/peek/peekLeft 进行可失败操作的函数式组合；结构化日志区分业务失败（warn/info）与系统失败（error）；受检与非受检异常的纪律；在异常不可避免时保留完整因果上下文的异常链。
使用方式：先运行 ./mvnw validate 或 mvn validate 校验项目，失败则立即停止；引入 Either 前确认存在 VAVR（io.vavr:vavr）与 SLF4J 依赖；阅读 references/143-java-functional-exception-handling.md 定位可替换的异常密集控制流；实施 Optional/Either/异步错误模式并配合结构化日志与清晰错误契约；最后运行 ./mvnw clean verify 或 mvn clean verify 验证。
适用场景：需要重构异常处理、提升错误可读性与可维护性的 Java 项目，尤其是业务逻辑失败可预期、需要异步错误处理的场景。
限制：应用前必须确保项目可校验，校验失败须停止；引入 Either 需确认 VAVR 与 SLF4J 依赖；参考文档按好/坏代码示例组织，需按适用示例应用建议。具体安装命令与更多细节暂未提供。