选型指南 架构设计 含可复制代码

沉默失败:最危险的失败是没有报错

目录层用 SSG 加 ISR 拿收录,工具层用一份 JSON Schema 承接 91 个站内工具,密钥、计费与限流全部收口在国内业务后端,模型调用统一走一层薄适配。这篇把我们真实的目录结构、Schema 字段定义、路由闸门、预扣结算伪代码和合规清单完整摊开。

陈
陈默架构组
2026-09-28 · 14 分钟阅读 · 8,432 次浏览

让系统静默返回空结果,多久会被发现?

最危险的失败是"没有报错"

有一类失败最难发现 ✗:系统"成功"返回了 ✔,但结果是错的或空的 ✔ ——

没有异常、没有报警、指标也正常 ✔(因为接口确实 200 ✔)。

这类"沉默失败"要靠专门的守卫来抓 ✔。

一、六种沉默失败

```

① 返回空结果但状态成功(检索没命中,却当"没有相关内容"返回)

② 答案格式对但内容空洞("这取决于具体情况")

③ 静默降级(走兜底但未标注,见降级链那篇)

④ 静默截断(输入/输出被切但没有说明)

⑤ 默认值兜底(字段缺失时用默认值填上,且不告知)

⑥ 部分成功(10 条里成功 3 条,只报成功)

```

第 ① 与 ⑤ 项最常见 ✗→✔。

二、五个守卫

| 守卫 | 抓什么 |

|---|---|

| 空结果率(按功能) | ①(突然升高说明检索或解析坏了 ✔) |

| 答案长度下限 | ②(低于阈值触发复核 ✔) |

| 降级标注率 | ③(降级了就必须有标注 ✔) |

| 截断计数 | ④(截断必须计数并呈现 ✔) |

| 默认值使用率 | ⑤(按字段统计 ✔ —— 高说明上游缺失 ✔) |

| 部分成功明细 | ⑥(必须报"成功 3 / 失败 7" ✔) |

要点:每个守卫都要有阈值与告警 ✗ ✔,否则等于没有 ✔。

三、为什么"指标正常"也会出事

因为常规指标看的是错误率(异常/失败 ✔),

而沉默失败不产生错误 ✔ —— 它产生的是"看起来正常的坏结果" ✔。

所以必须监控"结果质量的下限",而不仅是错误率 ✔:

· 空结果率 ✔;

· 平均输出长度 ✔(骤降是好信号 ✔);

· 用户追问率 ✔(答得不好 → 用户会追问 ✔ —— 这是最灵敏的间接信号 ✔)。

四、三个反模式

· 只监控 5xx ✗;

· 把"没结果"当成正常业务 ✗(没结果可能是故障 ✔);

· 部分成功只报成功 ✗(最容易被用户投诉的一类 ✔)。

五、一条判据

> 让系统"静默返回空结果" ✔,多久会被发现 ✔?

> 如果只能靠用户投诉才发现,说明沉默失败没有守卫 ✗。

本文由云枢 AI导航整理,内容以官方来源为准。

相关文章

顺序阅读

← 上一篇:长结果的呈现:分层、截断与续写
下一篇:AI 功能的可访问性:键盘与屏幕阅读器能用吗 →

第 162 / 171 篇

术语速查 · 本页出现的 12 个词展开看中文名与一句话解释,点术语看完整条目
  • token词元:模型处理文本的最小单位,中文约 1–2 个汉字;计费与上下文长度都按它算。
  • 转写 / 字幕Transcription:把音视频人声逐句变成带时间戳的文字稿,便于做字幕与章节切分。
  • SSE服务器发送事件:服务器通过长连接持续推送增量文本,是对白逐字出现的常见实现。
  • API应用编程接口:程序之间约定的调用方式;站内工具由服务端调用,浏览器里不出现密钥。
  • CDN内容分发网络:把静态资源缓存到离用户更近的节点,缩短加载时间。
  • 缓存Cache:把结果暂存复用,复用得越多平均耗时越低;需要约定过期与刷新策略。
  • 限流Rate Limit:限制单位时间内的请求次数,防止单用户或异常流量打满服务端。
  • SSG静态站点生成:构建阶段就生成 HTML,访问时直接返回,不必每次请求都渲染。
  • ISR增量静态再生:先返回静态页,再在后台按需重新生成,兼顾速度与更新时效。
  • 灰度发布Canary Release:先让一小部分用户用新版本,确认无误再放量,出问题的爆炸半径最小。
  • 提示词Prompt:交给模型的指令文本;写清角色、任务、输入与输出格式比反复试更省。
  • 积分Credits:站内计费单位:按工具单价预扣,调用失败自动退还;单价以定价页为准。

完整解释与站内出现处见 AI 术语表(40 条)。