自定义错误页

HTTP 网关支持自定义错误页：当请求返回 4XX 客户端错误时，向您指定的自定义 HTML 错误页返回给用户，替代默认错误页，保证错误场景下的品牌一致性与用户引导体验。

适用范围

自定义错误页目前仅对平台版开放。

配置入口

进入 云开发平台 - 平台设置 - 自定义域名，在「自定义错误页」区域点击「配置错误页」。

配置错误页

1. 点击「配置错误页」。
2. 选择需要自定义的错误状态码（仅支持 4XX 客户端错误状态码，如 401、403、404 等）。
3. 上传自定义错误页文件。支持 .html / .htm / .json / .xml 格式，单个文件大小不超过 2 MB。
4. 保存后，对应状态码的错误请求将返回您上传的错误页。

说明

• 面向所选 4XX 客户端错误返回自定义错误页。
• 同一状态码仅可配置一个错误页，重复配置时以最新上传的文件为准。

管理错误页

配置完成后，错误页列表展示已生效的配置：

列/操作	说明
状态码	该错误页覆盖的状态码，如 401、403、404、405、408、414、420、431 等
错误页文件	已上传的自定义错误页文件名，如 error-page-xxxx.html
编辑	修改状态码范围或替换错误页文件
预览	查看错误页。弹窗中提供「预览」与「页面内容」两个标签页：预览 展示错误页的实际渲染效果，页面内容 可查看错误页文件的源代码
删除	删除该错误页配置，对应状态码恢复返回默认错误页

提示

建议同时覆盖常见状态码（如 404、403），并在错误页中提供返回首页、联系支持等引导入口，降低错误场景下的用户流失。