本指南介绍如何识别和解决构建错误，以及排查 Workers Builds 部署流程中的常见问题。
要查看构建历史，请在 Cloudflare 仪表板中前往 Worker 项目，选择 Deployment（部署），在页面底部选择 View Build History（查看构建历史），然后选择要查看的构建。要重试构建，选择构建旁的省略号并选择 Retry build（重试构建）。或者，你可以在 Build Details 页面上选择 Retry build（重试构建）。
以下是构建日志中可能出现的常见构建错误，或一般问题及其解决方法。
✘ [ERROR] The name in your Wrangler configuration file (<Worker name>) must match the name of your Worker. Please update the name field in your Wrangler configuration file.（Wrangler 配置文件中的名称必须与 Worker 名称匹配。请更新配置文件中的 name 字段。）
将 Git 仓库连接到 Worker 项目时，Cloudflare 仪表板上指定的 Worker 名称必须与指定根目录中 Wrangler 配置文件里的 name 参数一致。如果不匹配，请更新 Wrangler 配置文件中的 name 字段以匹配仪表板上的 Worker 名称。
构建系统使用 Wrangler 配置文件中的 name 参数来确定要部署到 Cloudflare 全球网络的 Worker。此要求确保仪表板上的 Worker 名称与已部署的 Worker 一致。
✘ [ERROR] Missing entry-point: The entry-point should be specified via the command line (e.g. wrangler deploy path/to/script) or the main config field.（缺少入口点：应通过命令行或配置中的 main 字段指定入口点。）
如果看到此错误，根目录可能缺少 Wrangler 配置文件。导航到 Settings（设置） > Build > Build Configuration 以更新根目录，或在指定目录中添加 Wrangler 配置文件。
Could not route to /client/v4/accounts/<Account ID>/workers/services/<Worker name>, perhaps your object identifier is invalid? [code: 7003]（无法路由到该路径，对象标识符可能无效。）
如果看到此错误，Wrangler 配置文件可能包含其他账户的 account_id。移除 account_id 参数或使用你账户的 account_id 更新它，可在 Workers & Pages Overview（Workers & Pages 概览） 下的 Account Details（账户详情） 中找到。
Failed: The build token selected for this build has been deleted or rolled and cannot be used for this build. Please update your build token in the Worker Builds settings and retry the build.（失败：为此构建选择的构建令牌已被删除或轮换，无法用于此构建。请在 Worker Builds 设置中更新构建令牌并重试。）
Build Configuration 设置中的 API Token 下拉菜单可能显示已编辑、删除或轮换的过期令牌。如果遇到因过期令牌导致的错误，请创建新的 API Token 并选择它用于构建。
Build was timed out
最大构建持续时间为 20 分钟。如果构建超过此时间，构建将被终止并显示上述错误日志。更多详情，请参阅 Workers Builds 限制。
如果遇到与 Git 集成相关的错误，可以尝试从 Cloudflare 移除对 GitHub 或 GitLab 集成的访问，然后重新安装 GitHub 或 GitLab 集成。
如果你发现其他问题或想提供反馈，请在 Cloudflare Developers Discord ↗ 联系我们。