You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何通过vercel.json配置自定义404错误页面?

解决Vercel静态站点自定义404页面的配置问题

你当前用redirects的配置存在问题——它会把所有请求强制导向404页面,不管原页面是否存在,完全不符合需求。Vercel当前推荐使用errorPages属性配置自定义错误页面,效果和Apache的ErrorDocument一致。

正确的vercel.json配置

{
  "cleanUrls": true,
  "errorPages": {
    "404": "/status/404/index.html"
  }
}

配置说明

  • errorPages是Vercel官方支持的标准配置,专门用于自定义错误状态码对应的页面,替代了已弃用的routes方案。
  • 当用户访问不存在的路径触发404状态码时,Vercel会自动返回你指定的/status/404/index.html页面,同时保留404的响应状态码,不会影响SEO。
  • 确认你指定的路径确实存在于部署项目中:如果自定义404页面放在项目根目录的status/404/index.html,这个路径就没问题;若路径有变动,对应修改即可。

内容的提问来源于stack exchange,提问作者Lolete Sape

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.07 15:55:20