在应用服务上配置错误页(预览版)

本文介绍如何在 Web 应用上配置自定义错误页。 使用应用服务,可以配置特定错误的错误页以呈现给用户,而不是配置默认错误页。

先决条件

在本教程中,我们将自定义 403 错误页添加到应用服务上托管的 Web 应用,并使用 IP 限制对其进行测试。 为此,需要满足以下条件:

  • 在具有高级 SKU 的应用服务上托管的 Web 应用
  • 大小低于 10 kb 的 html 文件

上传错误页

在本示例中,我们将上传并测试要呈现给用户的 403 错误页。 将 HTML 文件命名为与错误代码匹配(例如 403.hmtl)。 准备好 html 文件后,即可将其上传到 Web 应用。 在配置边栏选项卡中,应会看到“错误页(预览)”选项卡。单击此选项卡可查看错误页选项。 如果选项灰显,则至少需要升级到高级 SKU 才能使用此功能。

选择要为其上传错误页的错误代码,然后单击“编辑”。 在下一个屏幕上,单击文件夹图标以选择你的 html 文件。 该文件必须采用 html 格式,且大小限制为 10 kb。 找到该 .html 文件,然后在屏幕底部单击“上传”按钮。 请注意,表中的“状态”从“未配置”更新为“已配置”。 然后单击“保存”以完成上传

确认错误页

上传并保存自定义错误页后,可以触发并查看该页面。 在此示例中,可以使用 IP 限制触发 403 错误。

若要设置 IP 限制,请转到“网络”边栏选项卡,然后单击“入站流量配置”下的“已启用访问限制”链接

在“站点访问和规则”部分下,选择“+添加”按钮以创建 IP 限制

在后面的窗体中,需要将“操作”更改为“拒绝”并填写“优先级”和“IP 地址块”。 在此示例中,我们使用在“网络”边栏选项卡上找到的入站地址,并将它设置为 /0(例如 12.123.12.123/0。 这会在访问站点时禁用所有公共访问。

填写“添加规则”窗体后,选择“添加规则”按钮。 然后单击保存

保存后,需要重启站点才能使更改生效。 转到概述页并选择“浏览”。 现在应会看到自定义错误页加载。

错误代码

应用服务目前支持三种类型的可用于自定义的错误代码:

错误代码 description
403 访问限制
502 网关错误
503 服务不可用

常见问题解答

  1. 我上传了错误页,为什么在触发错误时不显示该错误?

目前,仅当错误来自前端时,才会触发错误页。 在应用级别触发的错误仍应通过应用进行处理。

  1. 为什么错误页功能灰显?

错误页当前是高级功能。 至少需要使用高级 SKU 才能启用该功能。