用途:该技能介绍 TanStack Router 中两类“未找到”的处理方式——URL 路径未匹配(自动)与资源不存在(在 loader 或 beforeLoad 中手动 throw notFound()),以及按路由配置的错误边界。
主要能力:全局 404 可在根路由设置 notFoundComponent,或用 createRouter 的 defaultNotFoundComponent 做路由级默认;资源缺失时 throw notFound() 触发未找到边界,可用 notFound({ routeId }) 指定父路由、用 rootRouteId 指向根路由。notFoundMode 支持 fuzzy(默认,找最近带子路由且有 notFoundComponent 的父路由)与 root(全部交给根路由)。错误处理通过 errorComponent 接收 error、info、reset,重试应调用 router.invalidate() 以重跑 loader 并重置边界;也可用 defaultErrorComponent 设全局默认。notFoundComponent 中应使用 useParams、useSearch、useRouteContext,useLoaderData 可能为 undefined;可通过 notFound({ data }) 传递部分数据。路由掩码支持 Link 的 mask、useNavigate 的 mask、createRouteMask 声明式配置及 unmaskOnReload。
限制与注意:不要使用已废弃的 NotFoundRoute,否则 notFound() 与 notFoundComponent 不生效;只有带子路由(含 Outlet)的路由才能渲染 notFoundComponent,叶子路由的未找到会冒泡到最近父路由;掩码数据存于 location.state,分享或新标签页打开会丢失;单独调用 reset() 不会重跑 loader。