解锁 1年EdgeOne + 1TB CDN： 加入我们的开发者之旅
立即开始！
排障指南
在使用 EdgeOne Pages 的过程中，您可能会遇到各种错误。本节重点介绍操作 Pages 控制台时可能发生的错误及解决方案。
构建部署
输出目录异常
如果输出目录缺失、为空或无效，构建过程将会抛出错误（如“Output directory build does not exist!”）。要解决此问题，您可以尝试以下步骤：
确保在“项目设置 - 构建部署配置”中设置正确的输出目录
若不清楚输出目录，可在本地运行构建命令，并查看构建产物的输出位置
构建日志出现“File count exceeds project limit”
Pages 项目有 20000 个文件的数量限制，请排查后重试部署。
构建日志出现“File size exceeds the limit”
Pages 项目有单文件 25 MB 的大小限制，请排查后重试部署。
直接上传部署成功后页面 404
可排查上传的文件夹根目录下有没有 index.html 文件。
域名管理
DNS 记录不正确
在您的域名提供商添加 DNS 记录后，点击“验证”出现“您的记录配置不正确，请确保它指向正确的地址”。由于 DNS 记录生效有一定时间，可以稍等几分钟后重新进行验证。
注意：
若域名托管在 Cloudflare 上，其根域名（如 example.com）暂时无法作为自定义域名添加到 Pages，建议使用子域名（如 sub.example.com）。
域名已在其他平台存在
添加域名的时候出现“域名已经在其他腾讯云加速平台存在，请删除后重试”。可尝试在其他平台（腾讯云 CDN 或 EdgeOne）删除该域名，或者更换为其他二级域名。
平台默认证书部署超时
生成默认证书时，证书状态出现“部署超时”。需排查下添加的域名的根域名是否存在 CAA 记录，可临时移除该记录，待证书生成后重新添加 CAA 记录。
如何实现非 www 自动跳转到 www
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 系统，以管理员身份运行：右键编辑器图标，选择“以管理员身份运行”，排除因权限不足导致的问题
技术支持
