边缘开发者平台
  • Pages
    • 产品简介
    • 快速开始
      • 导入 Git 仓库
      • 从模板开始
      • 直接上传
    • 框架指南
    • 项目指南
      • 项目管理
      • edgeone.json
      • 错误码
    • 构建指南
    • 部署指南
      • 概览
      • 触发部署
      • 管理部署
      • 部署按钮
    • 域名管理
      • 概览
      • 自定义域名
      • 配置 HTTPS 证书
      • 如何配置 DNS 的 CNAME 记录
    • Pages Functions
    • KV 存储
    • 边缘 AI
    • EdgeOne CLI
    • Pages MCP
    • 最佳实践
      • 1 分钟快速部署 + 免费公测中|你的专属 DeepSeek,EdgeOne 承包了!
      • 将 WordPress Gastby 部署到 EdgeOne Pages
      • 使用 WordPress + GatsbyJS 搭建电商平台
      • 结合 Sanity 部署作品集模板
    • 迁移指南
      • 从 Vercel 迁移至 EdgeOne Pages
      • 从 Cloudflare Pages 迁移至 EdgeOne Pages
      • 从 Netlify 迁移至 EdgeOne Pages
    • 常见问题
    • 联系我们
    • 产品动态
解锁 1年EdgeOne + 1TB CDN: 加入我们的开发者之旅
立即开始!
当前为国际站中文文档,如需访问中国站文档,请点击这里

错误码

在使用 Pages 开发项目时,您可能会遇到各种错误。当访问您的站点出现问题时,页面将显示错误码及简要说明。这些错误可能涉及项目级别的访问问题或部署级别的状态异常。本章将针对常见错误情况提供具体解决方案。


错误码列表

错误码
说明
401
鉴权信息失效,请重新生成预览链接
404
该站点不存在,请检查您的访问地址
410
该部署已经删除,请重新部署
423
项目正在部署中,请稍候查看
424
项目部署失败,请查看部署记录以获取更多信息
451
项目已被封禁,您暂时无法访问该网站


错误码详情

401 - 鉴权信息失效

为保障内容合规,通过 项目域名 部署域名 访问 Pages 站点需遵循以下规则:

1. 项目加速区域设置为"中国大陆可用区"或"全球可用区(含中国大陆)":
1.1 须使用系统生成的预览链接进行访问,该链接有效期为 3 小时,超时后将返回 401 错误
1.2 可通过控制台"项目概览"界面右上角的"预览"按钮定期更新有效链接
2. 项目加速区域设置为"全球可用区(不含中国大陆)":
2.1 非中国大陆网络环境可直接访问,中国大陆网络环境将返回 401 错误

建议绑定自定义域名以建立稳定访问通道,全球可用区(不含中国大陆)无需备案。


404 - 站点不存在

请确认您访问的项目域名或部署域名是否正确。


410 - 部署已删除

当您删除某条部署记录后,再尝试访问该部署域名时,将返回 410 错误。部署可能因为版本更新、资源优化或管理需求而被删除。已删除的部署无法恢复,您可以选择创建新的部署。


423 - 项目正在部署中

如果项目正在进行首次部署,请耐心等待部署完成后再次访问。如果是非首次部署,您仍然可以访问项目,但将看到旧版本,待新部署完成后即可访问最新版本。


424- 部署失败

项目在构建过程中出现错误或其他原因导致部署失败将会出现 424 错误。
常见的失败原因包括:
构建脚本错误
依赖项缺失或版本不兼容
资源限制(如内存不足)
请在控制台查看对应项目的部署记录详情以获取日志,了解具体的失败原因。修复问题后,您可以重新创建部署。


451 - 项目已被封禁

由于违反平台规则,如涉及非法内容(涉黄、涉政等),项目被封禁且无法访问。请确保您的内容符合法律法规和平台规定。如果您认为这是一个误判,请通过社群或客服与我们联系以获取更多信息。



常见问题

Q: 我遇到了上述未提及的错误码,该怎么办?
A: 如果您遇到了文档中未涵盖的错误码,请记录下错误码和您的操作步骤,然后联系我们寻求帮助。


Q: 如何防止预览链接失效导致的 401 错误?
A: 最好的方法是为您的项目添加一个自定义域名。这样可以确保您始终可以通过该域名访问您的项目,而不依赖于有时效性的预览链接。


Q: 我的项目一直显示 423 错误(正在部署中),但似乎已经很久了,这正常吗?
A: 通常情况下,部署过程应该在几分钟内完成。如果您发现部署时间异常地长,建议检查您的部署日志,看是否有任何错误信息。如果问题持续,请联系我们。