用途:该技能用于处理 iii 引擎与 SDK 在 Node、Python、Rust 和浏览器 worker 中的错误,适合排查失败调用、超时、RBAC 拒绝、重试行为与 SDK 异常类等任务。
主要能力:iii 的错误分为 SDK/本地错误与引擎/远程调用错误两类,应按错误码而非消息字符串分支。常见错误码包括 function_not_found(无注册函数,检查函数 ID、worker 安装启动与发现)、invocation_error(引擎路由或记录失败,查引擎日志与 worker 连通性)、invocation_stopped(调用被取消或停止,视为失败工作)、FORBIDDEN(RBAC 拒绝,不要盲目重试,检查策略与授权上下文)、timeout(由目标 worker 返回并原样转发,引擎与 Node/Python SDK 不产生它,它们产生 TIMEOUT)、function_not_invokable(注册存在但不可作为普通本地函数调用)、invocation_failed(本地 handler、HTTP 调用包装或 SDK 侧失败)、TIMEOUT(Node/Python SDK 调用方超时)。
处理器错误来自用户函数代码、SDK 本地分发或 HTTP 端点;引擎错误来自路由、调用状态、RBAC、协议处理或 worker 上报的线上错误。队列重试仅适用于入队工作,同步失败直接返回调用方;void 分发不返回结果,需借助日志与可观测性。
可重试性:仅对幂等操作重试瞬时的 TIMEOUT(或目标 worker 返回的小写 timeout)、传输或 worker 重连失败;FORBIDDEN 在未改变认证或策略前不要重试;function_not_found 不要重复调用同一 ID,应发现函数或安装启动缺失 worker;可靠后台工作使用 TriggerAction.Enqueue({ queue }) 及队列重试/DLQ 策略。
用法:Node 使用 iii-sdk 的 InvocationError,Python 使用 iii 的 InvocationError,Rust 匹配 iii_sdk::Error::Timeout 与 Error::Remote,浏览器调用以 JavaScript 错误拒绝,保留引擎提供的 code/message,策略失败在 UI 显示为权限错误。
限制:不要自动重试非幂等工作,除非按队列策略入队;不要把 RBAC 拒绝当作缺失 worker;不要生成已移除的服务 API 或适配器扩展 API。调用模式与入队决策参考 iii-core-primitives,SDK 异常类参考 iii-sdk-reference,工作流重试与 DLQ 设计参考 iii-architecture-patterns,RBAC 策略见 rbac-proxy worker,worker 失败日志与追踪见 https://workers.iii.dev/。