让编码智能体沿用项目的错误边界
文章建议向编码智能体提供项目已有的错误边界层级、共享回退界面和日志约定,避免每个页面自行新增包装。重复或不合规范的边界可能吞掉错误、遗漏上报,并增加恢复逻辑的复杂度。
AI 深度解读
AI 给设置页加上 ErrorBoundary,看起来多了一层保护,却可能把原本该上报的异常截住,还顺手造出一套不同的报错界面。作者提醒:仓库已有错误隔离规则时,先让 Agent 读懂规则,再让它写页面。
这篇短文最有用的地方,是把「异常处理」从补一个组件,拉回到隔离范围、日志和恢复体验的共同约定。它没有给出实验数据,但提供了一套能直接用于提示词和代码审查的检查方法。
多包一层,为什么反而可能漏掉错误
原文举了一个场景:应用已经有路由级边界、编辑器的功能级边界,以及会向 logger 上报的共享兜底界面。Agent 新增设置页时,又套了一层:
<ErrorBoundary fallback={<p>Something went wrong</p>}>
问题不在于出现了 ErrorBoundary,而在于它改变了错误的去向。异常先被新边界接住,原有边界便没有机会处理;如果新边界没有调用既有的 logError,用户能看到提示,监控面板却可能没有记录。
两个相邻边界还可能使用不同的 fallback,也就是出错后显示的替代界面。究竟哪一层负责重试、恢复或退出,随后就更难判断。
错误边界的位置,是应用架构的一部分。
作者把 Agent PR 中临时增加的边界视为代码异味。这是一条审查信号,并非所有新边界都应该删除。
什么时候值得新增一个隔离层
作者认可几种新增边界的理由:第三方组件需要单独隔离、编辑器不能拖垮周围界面,或者某条路由此前确实没有被覆盖。
Modal 和 Drawer 也是一个具体例子。弹窗崩溃时,如果整个设置路由都退到错误页,影响范围可能过大。把弹窗单独隔离可以成立,但需要复用共享 fallback 和 logger,并在边界分布说明中记录这个隔离层。
新增边界前,先查看 app/error.tsx、src/lib/boundaries.md 和路由包装组件,确认谁已经负责捕获错误。原文在提示词中还用了 src/lib/error-boundaries.md,没有规定文档必须叫什么,重点是仓库应有可查的约定。
框架已经提供路由错误机制时,作者建议优先使用 Next.js 的 error.tsx 或 Remix 的 ErrorBoundary。不要在页面模块里随手添加 fallback={<div>Error</div>},也不要把异常吞掉后显示成空状态。
提示词要交代边界归谁管,审查还要看异步路径
作者给出的提示词,解决的是 Agent 不知道仓库现有规则的问题:
Here is how errors are isolated in this app (see src/lib/error-boundaries.md or the root ErrorBoundary).
Do not add a new ErrorBoundary around a page that is already covered.
If this feature needs isolation, use the shared fallback and logger, and update the map.
Do not invent a one-off “Something went wrong” message.
重点看第三行:如果确实需要隔离,新增边界、复用公共设施和更新分布说明要一起完成。作者还建议直接贴出分布说明或已有边界组件,审查时在 diff 中搜索 ErrorBoundary 和 componentDidCatch,要求每个新增命中都有理由。
另一个容易被 Agent 混淆的地方是异步错误。
渲染边界不会自动捕获一次失败的 fetch。
按原文的解释,需要把请求失败映射到状态或路由错误,才能进入相应的处理流程。看到 Agent 声称「加边界处理 API 错误」,应继续检查失败如何传递。已有查询库的错误 UI 或路由的 error.tsx,才是它应该先参考的位置。
我的判断
我赞同作者把审查重点放在「是否新增了隔离职责」上。与机械要求每个页面都包一层相比,这更容易保持日志和恢复体验一致,也能减少 Agent 根据通用示例随手拼装的代码。
不过,「新边界通常不对」是作者的经验判断,原文没有给出故障率或维护成本的对照数据。它尤其适合已经建立共享 fallback、logger 和边界分工的仓库。如果这些约定本来就缺失,仅禁止新增边界并不能补齐异常处理。
复用框架路由机制也有粒度前提:路由级处理适合整页失败,局部编辑器或弹窗仍可能需要独立隔离。判断标准应是出错后允许影响多大范围。
能拿来做什么
- 给 Agent 开发页面前,提供现有边界组件或分布说明,并明确路由、编辑器和弹窗分别由谁负责隔离。
- 审查 AI 生成的前端代码时,搜索新增的
ErrorBoundary和componentDidCatch,核对隔离理由、共享 fallback 与日志调用。 - 遇到「用边界处理 API 错误」的改动,沿着请求失败路径检查状态、查询库错误 UI 或路由错误处理,确认异常确实能到达预期界面。
- 新增独立隔离的 Modal、Drawer 或第三方组件时,同步记录隔离范围,避免下一次 Agent 又添加重复包装。