SuperAPI AI 工具集

123-java-exception-handling

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:在 Java 代码中识别并应用健壮的异常处理实践,提升错误清晰度、安全性、可调试性与系统可靠性。

主要能力:使用具体异常类型而非泛化的 Exception/RuntimeException;用 try-with-resources 自动清理资源;编写不泄露信息的异常消息;通过异常链保留完整错误上下文;用 IllegalArgumentException/NullPointerException 做早期输入校验;处理 InterruptedException 并恢复中断状态;编写 @throws JavaDoc 并遵循快速失败原则;使用带关联 ID 的结构化日志,避免重复记录并抛出;通过集中式异常映射器在 API 边界转换异常;仅对幂等操作做有界重试与退避;强制超时并传播截止时间;用 Throwable#addSuppressed 记录次要清理失败;不捕获 Throwable/Error;通过错误指标实现可观测性;处理异步 CompletionStage 代码中的失败传播。

使用方式:先运行 ./mvnw compile 或 mvn compile,若编译失败立即停止,待项目恢复有效状态后再继续;阅读 references/123-java-exception-handling.md 中的正反示例、约束与防护措施;按适用示例重构异常类型、资源处理、错误转换与日志模式;最后运行 ./mvnw clean verify 或 mvn clean verify 做完整验证。

适用场景:Java 项目的异常处理重构、资源管理、输入校验、日志与可观测性改进、API 错误转换、异步失败传播等。

限制:应用任何异常处理改动前必须确保项目可编译,编译失败须立即停止;改动后必须执行完整验证;具体示例与约束以参考文档为准。其他细节暂未提供。