立即迁移到 Netlify

Netlify 宣布 Gatsby Cloud 的下一次迭代。 了解更多

添加 404 页面

要创建 404 页面,请创建一个路径匹配正则表达式 ^\/?404\/?$ (例如 /404/, /404, 404/404) 的页面。最常见的是,您会在 src/pages/404.js 中创建一个 React 组件页面。

Gatsby 确保您的 404 页面被构建为 404.html,因为许多静态托管平台默认使用此文件作为 404 错误页面。如果您以其他方式托管您的网站,则需要设置自定义规则来为 404 错误提供此文件。

由于 Gatsby 默认会为您创建此页面,因此无需在 gatsby-node.js 文件中进行配置。

在使用 gatsby develop 进行开发时,Gatsby 会使用一个默认的 404 页面来覆盖您自定义的 404 页面。但是,您仍然可以通过点击“预览自定义 404 页面”来预览您的 404 页面,以验证其是否按预期工作。这在开发时很有用,因为您可以查看所有可用的页面。

下面的截图显示了 Gatsby 创建的默认 404 页面。它还列出了您网站上的所有页面。点击“预览自定义 404 页面”按钮,您就可以查看您创建的 404 页面。 Gatsby Default 404 Page

下图显示了自定义的 404 页面。 Gatsby Custom 404 Page

立即开始构建,在 Netlify!
在 GitHub 上编辑此页面
©2025Gatsby, Inc.