not-found.js
not-found 文件用于在路由段中抛出 notFound
函数时渲染 UI。除了提供自定义 UI 外,Next.js 会为流式响应返回 200
HTTP 状态码,非流式响应则返回 404
。
参考
Props
not-found.js
组件不接受任何 props。
须知:除了捕获预期的
notFound()
错误外,根目录的app/not-found.js
文件还会处理应用中所有未匹配的 URL。这意味着访问应用中未处理 URL 的用户将看到由app/not-found.js
文件导出的 UI。
示例
数据获取
默认情况下,not-found
是一个服务端组件 (Server Component)。您可以将其标记为 async
来获取并显示数据:
如果需要使用客户端组件 (Client Component) 的钩子如 usePathname
来根据路径显示内容,则必须在客户端获取数据。
版本历史
版本 | 变更 |
---|---|
v13.3.0 | 根目录 app/not-found 开始处理全局未匹配的 URL。 |
v13.0.0 | not-found 功能引入。 |