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

使用自定义 404 页面

在此页面上

  • Overview
  • 步骤

Overview

您可以替换默认的404 页面 当用户尝试访问权限自定义 HTML文档中不存在的资源时， Atlas App Services会显示此信息。您可以从App Services用户界面指定此自定义404页面，也可以导入在 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

来年

使用自定义域名

在此页面上