使用者体验差距： 一个是“这程序真垃圾”。另一个是“这 AI 真聪明”。如果你曾经在客服聊天里遇到类似崩溃日志，那一定让人头疼。

为什么错误处理很关键？

维度没有错误处理有错误处理 使用者体验崩溃、迷茫流畅、专业可用性首次失败就放弃自动恢复，成功率提高30%+ 调试难度无法定位问题标准化错误信息。快速定位AI智能感像个bug像个聪明的助手

错误的分类与识别

工具错误的五大家族

错误类型示例特征AI 能做什么

错误的可恢复性判断

// 错误可恢复性分类interface ErrorClassification { recoverable: boolean action: 'retry' | 'fix-params' | 'ask-user' | 'abort' maxRetries?: number retryDelay?: number}const errorStrategies: Record = { // 可恢复的错误 'NETWORK_TIMEOUT': { recoverable: true,action: 'retry',maxRetries:,retryDelay: },'RATE_LIMIT': { recoverable: true,action: 'retry',maxRetries:,retryDelay: },'INVALID_PARAM': { recoverable: true,action: 'fix-params',maxRetries: },// 不可恢复的错误 'PERMISSION_DENIED': { recoverable: false。action: 'abort' },'RESOURCE_NOT_FOUND': { recoverable: false,action: 'ask-user' },'AUTH_FAILED': { recoverable: false,action: 'abort' }}

标准化错误信息设计

错误信息的结构化模板

/** * 标准化错误信息接口 * 让AI能够理解错误并采取行动 */
interface StandardizedError {
error:{
至于code，string;message:string;怎么说呢，type:string;recoverable:boolean;suggestion，:string;details，:any;retryAfter，:number;correctedParams?
话说回来，:Record;}}，怎么说呢，

好错误 vs 坏错误

坏错误

Error: Cannot read property ‘name’ of undefined
at getWear
at processRequest 

好错误

{
"error":{
说到"code"。"USER_NOT_FOUND","message":"使用者ID ’abc123’ 不存在于程序中","type":"business","recoverable":true,"suggestion":"请检查使用者ID是否正确。如需帮助，可以询问使用者提供正确ID或使用邮箱搜索","details":{
"invalidId":"abc123"。"validFormat":"user_xxxxxxxx"
}
}
}

当 AI 看见这个结构化信息后它能马上判断：业务型、可修复，并给出针对性的提示。如果你曾经在日志里看到类似杂乱堆栈。那就要把它转成这种格式，让 AI “读懂”。

不同类型异常实战演练

参数校验与重试

如果你在输入城市名时常遇到拼写或同义词问题。可在代码里添加映射表，让 AI 自动纠正。比如把 “帝都”“beijing”“bj” 全部映射为 “北京”，接下来再重试一次。这正是我们上面演示中的 .

若你想进一步体验更好。可以把建议直接返回给前端，让终端使用者得到更友好的提示。如果还有其它业务参数，比如订单 ID 或者产品 SKU。只需按相同思路 映射表即可。

您可以把此段落拷贝到自己的工具中，接下来观察是否真正减少了“无效参数导致报错”的次数。—— 请记得在正式环境开启 debug 日志，以便快速定位仍未被覆盖的问题。—— 注意若某些参数确实不可修复，直接返回 recoverable:false 并告知使用者即可避免冗余重试。

⚠️ 小贴士 * 在开发阶段，你可以先模拟各种输入来验证映射表是否完整；* 对于高频调用服务，请考虑将映射表缓存到 Redis 或 CDN，以降低 CPU 开销；* 如果你的业务对输入敏感度极高，建议加上人工审核层级，以防误判。

继续往下看。如果你对其它异常类别也有疑惑，我已准备了一段统一模式代码供你参考。

如果您在开发过程中碰到了哪些棘手且重复出现的问题，请把经验贴出来我们一起讨论如何用标准化、可恢复性和它们吧！