排障指南

在使用 EdgeOne Pages 的过程中，您可能会遇到各种错误。本节重点介绍操作 Pages 控制台时可能发生的错误及解决方案。
﻿
构建部署
输出目录异常
如果输出目录缺失、为空或无效，构建过程将会抛出错误（如“Output directory build does not exist!”）。要解决此问题，您可以尝试以下步骤：
确保在“项目设置 - 构建部署配置”中设置正确的输出目录
若不清楚输出目录，可在本地运行构建命令，并查看构建产物的输出位置
﻿
构建日志出现“The account storage limit is 5 GiB. Please delete some deployments to proceed.”
Pages 有 5 GB 的存储容量限制，请删除部分部署记录后重试部署。
﻿
构建日志出现“File count exceeds project limit”
Pages 项目有 20000 个文件的数量限制，请排查后重试部署。
﻿
构建日志出现“File size limit exceeded. The maximum size for a single file is 25 MiB.”
Pages 项目有单文件 25 MB 的大小限制，请排查后重试部署。
﻿
直接上传部署成功后页面 404
可排查上传的文件夹根目录下有没有 index.html 文件。
﻿
﻿
域名管理
DNS 记录不正确
在您的域名提供商添加 DNS 记录后，点击“验证”出现“您的记录配置不正确，请确保它指向正确的地址”。由于 DNS 记录生效有一定时间，可以稍等几分钟后重新进行验证。
注意：
若域名托管在 Cloudflare 上，其根域名（如 example.com）暂时无法作为自定义域名添加到 Pages，建议使用子域名（如 sub.example.com）。
﻿
域名已在其他平台存在
添加域名的时候出现“域名已经在其他腾讯云加速平台存在，请删除后重试”。可尝试在其他平台（腾讯云 CDN 或 EdgeOne）删除该域名，或者更换为其他二级域名。
﻿
平台默认证书部署超时
生成默认证书时，证书状态出现“部署超时”。需排查下添加的域名的根域名是否存在 CAA 记录，可临时移除该记录，待证书生成后重新添加 CAA 记录。
﻿
如何实现非 www 自动跳转到 www
可在 edgeone.json 里面配置 redirects 字段，详情可参考文档 项目指南 - edgeone.json。
﻿
﻿
Pages MCP
deploy_html 工具未找到
添加 MCP Server 后出现报错 {"error": "MCP error -32602: MCP error -32602: Tool deploy_html not found"}，可尝试重启编辑器。
﻿
MCP Server 状态异常，显示“Client closed”
1.可尝试重启编辑器
2.若是 window 系统，以管理员身份运行：右键编辑器图标，选择“以管理员身份运行”，排除因权限不足导致的问题
﻿
﻿
技术支持
如果您遇到的问题没有对应的解决方案，或者需要更多有关 Pages 的技术指导，可以加入我们在 Discord 上的服务器 EdgeOne Developers。
﻿
﻿