---
title: "Error Surface vs Root Cause"
type: concept
last_updated: 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]]: 分层配置导致问题藏在不同层级

## Sources
- [[养虾日记4-一次「context-limit-exceeded」错误排查-我以为是小问题-结果踩了大坑]]