# Gateway 稳定性故障模式分类（2026-08-01）

## 故障模式一：配置漂移
- 症状：model.provider 为空，Gateway 用错误组合发请求 → 404
- 修复：hermes config set model.default deepseek/deepseek-v4-pro && model.provider deepseek

## 故障模式二：会话上下文爆炸
- 症状：飞书回复 3-7 字符，API 超时，restart 60s 超时
- 诊断：grep "Persisted transcript lagged" gateway.log → disk > 100 = 危险
- 修复：kill PID; hermes gateway start → 飞书 /reset

## 故障模式三：API 内容审核
- 症状：HTTP 400 Content Exists Risk（非 Gateway bug）
- 应对：换表述即可，不重启

## 故障模式四：DNS 不可达
- 症状：Failed to resolve open.feishu.cn
- 修复：等待飞书 SDK 自动重连或重启

## 故障模式五：state.db 损坏
- 修复：mv state.db state.db.corrupt && hermes gateway start

## 监控
- 脚本：~/.hermes/scripts/gateway_health_check.sh（四维度检测）
- Cron：f0d05a94bef0（每2h，异常报警不重启）