React Router v7 中的 `ErrorBoundary` 详解

🛡️ 什么是 ErrorBoundary?

ErrorBoundary 是 React Router v7 中的错误边界组件,它会在以下情况下自动被调用:

  1. 路由加载失败 (loader 函数抛出错误)
  2. 组件渲染错误 (React 组件抛出异常)
  3. Action 执行失败 (action 函数抛出错误)
  4. 404 错误 (路由不存在)
  5. 其他 HTTP 错误 (如 500、403 等)

🔄 ErrorBoundary 的工作流程

让我用图表展示 ErrorBoundary 在应用中的位置:

📋 ErrorBoundary 的错误处理逻辑

jsx 复制代码
export function ErrorBoundary({ error }: Route.ErrorBoundaryProps) {
  let message = "Oops!";
  let details = "An unexpected error occurred.";
  let stack: string | undefined;

  if (isRouteErrorResponse(error)) {
    message = error.status === 404 ? "404" : "Error";
    details =
      error.status === 404
        ? "The requested page could not be found."
        : error.statusText || details;
  } else if (import.meta.env.DEV && error && error instanceof Error) {
    details = error.message;
    stack = error.stack;
  }

  return (
    <main className="pt-16 p-4 container mx-auto">
      <h1>{message}</h1>
      <p>{details}</p>
      {stack && (
        <pre className="w-full p-4 overflow-x-auto">
          <code>{stack}</code>
        </pre>
      )}
    </main>
  );
}

🎯 错误类型处理

  1. 路由响应错误 (isRouteErrorResponse(error))

    • 404 错误:显示 "页面未找到"
    • 其他 HTTP 错误:显示状态文本
  2. 开发环境的 JavaScript 错误

    • 显示错误消息和堆栈跟踪
    • 仅在开发模式下显示详细信息
  3. 通用错误

    • 显示通用错误消息

📚 ErrorBoundary 总结

🎯 ErrorBoundary 的核心作用

  1. 全局错误捕获 - 捕获整个应用中的未处理错误
  2. 用户友好的错误显示 - 显示友好的错误页面而不是白屏
  3. 开发调试支持 - 在开发模式下显示详细的错误信息
  4. 应用稳定性 - 防止单个错误导致整个应用崩溃

🔄 与 Layout 的关系

jsx 复制代码
// 渲染层次:
Layout({ children: ErrorBoundary }) // 当有错误时
  └── ErrorBoundary({ error }) 
      └── 错误页面内容

// 正常情况:
Layout({ children: App }) // 正常情况
  └── App() 
      └── <Outlet /> 
          └── 正常页面组件

🛠️ 自定义 ErrorBoundary

你可以根据不同的错误类型提供不同的处理:

  • 404 错误 - 显示 "页面未找到"
  • 500 错误 - 显示 "服务器错误"
  • 网络错误 - 显示 "网络连接问题"
  • 权限错误 - 显示 "访问被拒绝"

ErrorBoundary 是 React Router v7 提供的强大错误处理机制,确保你的应用即使在出现错误时也能保持良好的用户体验。

相关推荐
澹锦汐6 小时前
纯前端秋日银杏与枫叶落叶色板智能聚类器:基于 K-Means 色彩量化与直方图自动配方提取
前端·人工智能·ai·语言模型·vue·react·k-means
Flynt13 小时前
AI 写的 Three.js 大屏,为什么越跑越卡?我在 Node 里复现了它的内存曲线
前端·ai编程·three.js
一个游离的指针15 小时前
Vue2:vue-router
前端·javascript·vue.js
火山引擎和TA的超级拍档们17 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
JavaGuide17 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程
niceyayale18 小时前
WebRTC 延迟怎么调试:从 ICE 到 jitter buffer 的六个观测点
前端
aleimu18 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端
tryCbest18 小时前
Vue系列——第 20 篇:Vue Router 4——路由管理完全指南(上)
前端·javascript·vue.js
feixing_fx18 小时前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
一条破秋裤18 小时前
【1115】【多线程】【笔记】
前端·chrome·笔记