1.1 KiB
1.1 KiB
title, type, last_updated
| title | type | last_updated |
|---|---|---|
| Error Surface vs Root Cause | concept | 2026-04-10 |
Definition
错误表象（Error Surface）是指错误信息字面上描述的问题，而根本原因（Root Cause）是导致错误发生的真正系统状态。"Context Limit Exceeded"字面上提示"对话太长"，但真实原因可能是"模型配置错误"。
Core Principle
不要默认认为错误信息就是表面意思。先问一句：到底哪儿出问题了？
Debugging Mindset
| 错误表象 | 根本原因 |
|---|---|
| Context limit exceeded = 对话太长 | 模型 context window 太小 |
| Session 文件爆满 = 文件需要清理 | 模型切换导致 token 立即耗尽 |
| 重启后问题复发 = 持久化配置错误 | Agent 路由规则在启动时重新加载 |
Related
- Log-Driven-Debugging: 通过日志还原真实系统状态
- Hidden-Failure-Paths: 复杂系统中的隐藏故障路径
- Layered-Configuration: 分层配置导致问题藏在不同层级