Docs 菜单
Docs 主页
/
MongoDB Atlas
/
Atlas App Services
/
参考
/
主机文件 [已弃用]

使用自定义 404 页面

在此页面上

  • Overview
  • 步骤
  • 创建自定义 404 页面文件
  • 在 App Services 中托管 404 文件
  • 在 App Services 中配置 404 资源路径
  • 拉取最新版本的应用程序
  • 创建自定义 404 页面 HTML 文件
  • 在 App Services 中托管 HTML 文件
  • 在应用程序配置中指定 404 页面
  • 部署更新的主机配置

Overview

您可以替换默认的404 页面 当用户尝试访问自定义 HTML 文档中不存在的资源时，Atlas App Services 会显示此消息。您可以从404 App Services 用户界面指定此自定义 页面，也可以 导入 在hosting 目录中包含该页面的应用程序配置目录。选择下面与您要使用的方法相对应的标签页。

注意

单页面应用程序中的 404 错误

启用单页面应用程序托管后，无论请求的路由如何，App Services 始终返回带有应用程序根目录的 HTTP 200 响应。 这意味着您无法为 SPA指定自定义 404 页面。 相反，您应该在应用程序中包含自定义代码来处理无效路由。

步骤

1

创建自定义 404 页面文件

您可以使用任何托管文件作为自定义 404 页面。 通常使用包含以下元素的 HTML 文件：

  • 指示错误的短消息，例如 “此页面不存在。”

  • 用户继续导航的替代链接或选项。

2

在 App Services 中托管 404 文件

创建自定义404文件后，您需要将其上传到 App Services 。要上传文件，请导航到 App Services 用户界面的 Hosting屏幕，单击Upload Files ，然后选择自定义 HTML 文件。

3

在 App Services 中配置 404 资源路径

成功上传 404 文件后，剩下的就是将 App Services 配置为提供该文件，而不是默认的 404 页面。

  1. 在Hosting页面上，单击Settings标签页。

  2. 在 Custom 404 Page 下，单击 Choose File。

  3. 从列表中选择自定义 404 文件。

  4. 单击 Save（连接）。

更新Hosting配置后，App Services 将开始提供自定义文件，而不是默认的 404 页面。

1

拉取最新版本的应用程序

要使用App Services CLI配置自定义 404 页面，您需要应用程序配置文件的本地副本。

要提取最新版本应用的本地副本，请运行以下命令：

appservices pull --remote="<Your App ID>"

提示

您还可以从 App Services 用户界面的Deploy > Import/Export App屏幕下载应用程序配置文件的副本。

2

创建自定义 404 页面 HTML 文件

您可以为应用程序的 404 页面使用任何有效的 HTML 文件。 考虑纳入以下元素：

  • 指示错误的短消息，例如 “此页面不存在。”

  • 用户继续导航的替代链接或选项。

3

在 App Services 中托管 HTML 文件

创建自定义 HTML 文件后，您需要将其托管在 App Services 中。

如果您尚未在 App Services 中托管 HTML 文件，请将其添加到hosting/files/目录中。

4

在应用程序配置中指定 404 页面

在hosting/config.json中，将default_error_path设置为 404 页面 HTML 文件的资源路径，然后保存配置文件。

"hosting": {
  "enabled": true,
  "default_error_path": "/pages/custom_404.html"
}
5

部署更新的主机配置

更新hosting/config.json后，您可以将更新的配置推送到远程应用程序。 如果您还添加了 404 页面，请确保使用--include-hosting标志。 App Services CLI 在推送时立即开始提供自定义 404 页面。

appservices push --remote="<Your App ID>" --include-hosting

后退

将内容上传到 Atlas App Services