更新时间:2025-06-26 GMT+08:00

配置自定义错误页面

用户访问报错时,会给客户端返回错误页面,而此时的页面一般不美观。您可以在CDN控制台设置自定义错误页面,当访问页面出错时,会给客户端返回指定的页面,优化用户体验。

注意事项

  • 支持对4xx、5xx状态码设置自定义错误页面。
  • 如果自定义页面是CDN加速的资源,那么将按照正常CDN计费规则计费。
  • 后台有特殊配置的域名,暂不支持配置自定义错误页面。

配置步骤

  1. 登录华为云控制台,在控制台首页中选择CDN与智能边缘 > 内容分发网络 CDN,进入CDN控制台。
  2. 在左侧菜单栏中,选择域名管理
  3. 在域名列表中,单击需要修改的域名或域名所在行的“设置”,进入域名配置页面。
  4. 选择“高级配置”页签。
  5. 在自定义错误页面配置模块,单击“添加”,系统弹出“自定义错误页面配置”对话框。
    图1 自定义错误页面配置
    表1 参数说明

    参数

    描述

    示例

    错误码

    需要自定义页面错误码4xx、5xx。

    404

    执行规则

    Break:如果错误码匹配了当前配置,请求将被重定向到目标Path。执行完当前规则后,当存在其他配置规则时,将不再匹配剩余规则。

    Redirect:如果错误码匹配了当前配置,请求将被重定向到目标Path。执行完当前规则后,当存在其他配置规则时,将继续匹配剩余规则。

    Break

    重定向目标地址

    “执行规则”选择“Break”时:全路径匹配,支持输入一个目标地址,以“/”作为首字符,字符长度不超过512,如:/errorcode.html。

    “执行规则”选择“Redirect”时:输入的URL须以http://或https:// 开头 ,字符长度不超过512,包含完整的域名和路径信息,如:http://example.com/errorcode.html。

    /errorcode.html

    重定向方式

    “执行规则”选择“Redirect”时需要配置该参数,配置错误码页面重定向到新页面的方式,可选301或302重定向。

    301

  6. 输入各项参数,单击“确定”,完成配置。

配置示例

源站服务器已删除图片“abc.jpg”且CDN节点的缓存已过期,当用户访问https://example.com/abc.jpg时,客户端返回404状态码,如果您做了如下配置:

结果:当用户访问https://example.com/abc.jpg时,会跳转到https://example.com/error404.html。