Bazel “no matching toolchains found”
Bazel could not find a registered toolchain whose type and constraints satisfy the target and execution platform requirements.
Common causes
- The required toolchain was not registered
- Constraint values differ between toolchain and platform declarations
- Repository or module registration is missing
- The selected execution platform excludes every candidate
What to check
- Run the failing command with --toolchain_resolution_debug=regex (use .* for all resolution details)
- List registered execution platforms and their constraints
- Compare target, execution-platform, and toolchain compatibility constraints
- Check WORKSPACE or MODULE.bazel registration and visibility
Primary sources
Use these references to confirm protocol and version-specific behavior.
Investigate with build-level evidence
Hermetiq correlates Bazel actions, cache behavior, Buildbarn infrastructure, and remote-execution timing so teams can move from a status code to the build and system behavior behind it.
Technical review: July 20, 2026 · Verify flags and behavior against the Bazel and Buildbarn versions deployed in your environment.