自定义错误页
HTTP 网关支持自定义错误页。当请求返回支持的 4XX 客户端错误时，网关向用户返回自定义错误页，替代默认错误页。
适用范围
自定义错误页目前仅对平台版开放。
配置入口
进入 云开发平台 - 平台设置 - 自定义域名，在“自定义错误页”区域点击“配置错误页”。
配置错误页
- 点击“配置错误页”。
- 选择需要自定义的错误状态码，支持 401、402、403、404、423、429、451。各状态码的场景见下表，相关错误码参考语义化 HTTP 状态码。
- 上传自定义错误页文件。支持
.html/.htm/.json/.xml格式，单个文件大小不超过 2 MB。 - 保存后，对应状态码的错误请求将返回上传的错误页。
| 状态码 | 场景说明 |
|---|---|
| 401 | 鉴权失败：凭证缺失、无效或过期 |
| 402 | 欠费、超套餐、环境停服或资源隔离 |
| 403 | 权限不足或访问策略拒绝 |
| 404 | 资源、域名或路径不存在 |
| 423 | 功能未启用、路由禁用或域名未接入环境 |
| 429 | 频率、配额或并发超限 |
| 451 | 封禁或合规拦截 |
说明
- 面向所选 4XX 客户端错误返回自定义错误页。
- 同一状态码仅可配置一个错误页，重复配置时以最新上传的文件为准。
- 402 包含环境停服：套餐到期隔离、资源点耗尽或欠费导致环境停服时，该环境下的所有请求均返回 402，可通过错误页引导用户续费或开启超限按量。
管理错误页
配置完成后，错误页列表展示已生效的配置：
| 列/操作 | 说明 |
|---|---|
| 状态码 | 该错误页覆盖的状态码，可选 401、402、403、404、423、429、451 |
| 错误页文件 | 已上传的自定义错误页文件名，如 error-page-xxxx.html |
| 编辑 | 修改状态码范围或替换错误页文件 |
| 预览 | 查看错误页。弹窗中提供“预览”与“页面内容”两个标签页：预览 展示错误页的实际渲染效果，页面内容 可查看错误页文件的源代码 |
| 删除 | 删除该错误页配置，对应状态码恢复返回默认错误页 |
提示
建议同时覆盖常见状态码（如 404、403），并在错误页中提供返回首页、联系支持等引导入口，降低错误场景下的用户流失。