技术与测试 核心 B · 官方指南或术语 平台: 网页

Error Boundary

错误边界

错误边界会接住组件树中一小部分的界面错误。它只在出错位置显示安全替代内容。

看看怎样运作
也有人这样说 Error Boundary组件错误边界界面错误替代内容崩溃边界

看看怎样运作

原创情境示例错误边界

另一个例子

一张图表发生错误。导航和其他仪表板卡片仍可正常使用。

主要部分

  1. 01受保护的组件树
  2. 02捕获的错误
  3. 03局部替代内容
  4. 04仍可使用的相邻区域
  5. 05重新加载操作

什么时候用

某个界面区域可能单独失败时,可以在它外面放置错误边界。

什么时候不要用

不要用它处理普通表单错误或请求失败。这些情况应有正常的错误状态。

代码里的名称

protected subtree + caught render error + fallback + reset

上线前要检查

检查程序运行环境与版本、集成边界、依赖与许可,以及支持的平台。验证安全、失败处理、性能与监控。也要检查部署、支持负责人、升级路径与恢复上一版的方法。

可以直接复制的需求

预期结果:把 错误边界 (Error Boundary) 当作团队能维护的技术基础,并检查它是否符合产品需求。 用户场景:一张图表发生错误。导航和其他仪表板卡片仍可正常使用。 技术或工程概念:错误边界 (Error Boundary)。 适用理由:某个界面区域可能单独失败时,可以在它外面放置错误边界。 不应使用的情况:不要用它处理普通表单错误或请求失败。这些情况应有正常的错误状态。 工程适配:定义程序运行环境与版本。说明它负责什么、接口、数据流、依赖、支持平台、安全与性能限制,以及如何接入现有技术组合。 生命周期防护:检查依赖是否健康、许可是否可用。加入监控与安全备用做法,并指定升级负责人。没有可衡量的好处时,不要再加入功能重复的框架或工具。 验收标准:用最小集成证明必要行为。测试兼容性、安全性、失败与性能。记录部署、升级、支持与恢复上一版的方法。 证据与限制(证据边界):它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认:现有技术组合、运行环境、版本规则、目标平台和依赖负责人。也要确认性能预算、支持期限与迁移限制。

检查这份需求

请 AI 编程助手检查当前如何使用 错误边界 (Error Boundary)。 定义:错误边界会接住组件树中一小部分的界面错误。它只在出错位置显示安全替代内容。 生产环境检查:检查程序运行环境与版本、集成边界、依赖与许可,以及支持的平台。验证安全、失败处理、性能与监控。也要检查部署、支持负责人、升级路径与恢复上一版的方法。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

B
这个术语有多正式?

官方指南或术语

列出的平台、框架、项目或专业组织,发布了这个术语的官方指南。

它只代表该来源的官方说法。其他平台或团队可能有不同用法。

适用范围
只包含来源有说明的内容:正式名称、定义、平台 API、实现、使用指南
文档状态
稳定
核验日期
2026-07-30

证据来源与适用范围

正式来源 + 术语参考资料 · React · 稳定 Catching rendering errors with an error boundary 适用范围: 正式名称、定义、平台 API、实现、使用指南 本页用途: 直接术语参考 来源涵盖内容: 正式名称, 定义, 平台 API, 实现, 使用指南

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。