27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
---
|
||
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」错误排查-我以为是小问题-结果踩了大坑]]
|