error-handling-patterns

错误处理模式技能详解

技能概述

Error Handling Patterns 是一个专注于构建弹性应用的错误处理技能，涵盖异常处理、Result 类型、错误传播和优雅降级等核心模式，帮助开发者在实现错误处理、设计 API 或提升应用可靠性时做出正确决策。

适用场景

新功能实现错误处理

在开发新功能时设计合理的错误处理策略，包括异常捕获、错误信息返回和恢复机制，确保应用在面对异常情况时能够优雅处理而不是崩溃。

设计可靠的 API

构建前端或后端 API 时，设计清晰的错误响应结构、错误码规范和错误消息格式，让调用方能够准确理解错误原因并采取适当的处理措施。

生产环境问题排查

当应用在生产环境出现错误时，使用结构化的错误处理模式快速定位问题根源，通过完善的错误日志和追踪信息缩短调试时间。

核心功能

多语言错误处理模式

涵盖主流编程语言的错误处理机制，包括基于异常的模式（Java、Python、C#）、基于 Result 类型的模式（Rust、Go、Swift）以及基于错误值的模式，帮助开发者选择适合当前项目的错误处理方式。

错误传播与恢复策略

提供完整的错误传播链设计方法，包括如何在不同层级间传递错误上下文、何时包装错误、何时让错误冒泡，以及重试机制、断路器模式和优雅降级等恢复策略的具体实现。

分布式系统容错设计

专门针对分布式系统和微服务架构的错误处理模式，包括超时处理、级联失败预防、服务降级策略以及跨服务错误追踪，帮助构建高可用的分布式应用。

常见问题

Result 类型和异常处理哪个更好？

Result 类型更适合预期的错误情况（如用户输入验证失败、资源未找到），这类错误是业务逻辑的一部分，应该被显式处理。异常则更适合意外的、程序无法继续执行的情况（如网络中断、数据库连接失败）。选择哪种方式取决于编程语言支持和团队编码规范。

API 错误响应应该包含哪些信息？

一个良好的 API 错误响应应包含：机器可读的错误码（用于程序判断）、人类可读的错误消息（面向开发者）、错误发生的上下文信息（如请求参数、资源标识），以及可选的帮助文档链接。避免在错误消息中暴露敏感的系统内部信息。

什么时候应该使用重试机制？

重试机制适用于临时性故障，如网络抖动、服务暂时不可用或资源锁竞争。使用时需要设置最大重试次数、退避策略（如指数退避）和可重试的错误类型判断。对于逻辑错误（如权限不足、数据验证失败）或已知的持久性故障，不应使用重试，而应快速失败并通知用户。