Troubleshooting builds
This guide explains how to identify and resolve build errors, as well as troubleshoot common issues in the Workers Builds deployment process.
To view your build history, go to your Worker project in the Cloudflare dashboard, select Deployment, select View Build History at the bottom of the page, and select the build you want to view. To retry a build, select the ellipses next to the build and select Retry build. Alternatively, you can select Retry build on the Build Details page.
Here are some common build errors that may surface in the build logs or general issues and how you can resolve them.
✘ [ERROR] The name in your wrangler.toml file (<Worker name>) must match the name of your Worker. Please update the name field in your wrangler.toml file.
When connecting a Git repository to your Workers project, the specified name for the Worker on the Cloudflare dashboard must match the name argument in the wrangler.toml file located in the specified root directory. If it does not match, update the name field in your wrangler.toml file to match the name of the Worker on the dashboard.
The build system uses the name argument in the wrangler.toml to determine which Worker to deploy to Cloudflare's global network. This requirement ensures consistency between the Worker's name on the dashboard and the deployed 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.
If you see this error, a wrangler.toml is likely missing from the root directory. Navigate to Settings > Build > Build Configuration to update the root directory, or add a wrangler.toml to the specified directory.
Could not route to /client/v4/accounts/<Account ID>/workers/services/<Worker name>, perhaps your object identifier is invalid? [code: 7003]
If you see this error, the wrangler.toml likely has an account_id for a different account. Remove the account_id argument or update it with your account's account_id, available in Workers & Pages Overview under 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.
The API Token dropdown in Build Configuration settings may show stale tokens that were edited, deleted, or rolled. If you encounter an error due to a stale token, create a new API Token and select it for the build.
Build was timed out
There is a maximum build duration of 20 minutes. If a build exceeds this time, then the build will be terminated and the above error log is shown. For more details, see Workers Builds limits.
If you are running into errors associated with your Git integration, you can try removing access to your GitHub or GitLab integration from Cloudflare, then reinstalling the GitHub or GitLab integration.
If you discover additional issues or would like to provide feedback, reach out to us in the Cloudflare Developers Discord ↗.