立即迁移到 Netlify

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

添加 500 页面

要添加 500 错误页面,请创建一个路径与正则表达式 ^\/?500\/?$ 匹配的页面(例如 /500//500500/500)。最常见的做法是创建一个 React 组件页面,位于 src/pages/500.js

当页面中的 getServerData 函数发生运行时错误时,用户将看到 500 错误页面。

Gatsby 确保您的 500 页面被构建为 500.htmlGatsby Cloud 支持显示此自定义 500 页面。如果您以其他方式托管您的站点,您需要设置自定义规则来为 500 错误提供此文件。

在使用 gatsby develop 进行开发时,您可以通过访问 localhost:8000/500 来预览您的 500 页面。

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