{"record":{"id":"ed46d9ad330d6ab6","repo":"gradle/gradle","slug":"unable-to-download-toolchain-matching-the-requirem-ed46d9","errorCode":null,"errorMessage":"Unable to download toolchain matching the requirements ({}) from '{}', due to: Invalid toolchain download url {} for {} on {} architecture.","messagePattern":"Unable to download toolchain matching the requirements \\((.+?)\\) from '(.+?)', due to: Invalid toolchain download url (.+?) for (.+?) on (.+?) architecture\\.","errorType":"exception","errorClass":"ToolchainDownloadException","httpStatus":null,"severity":"error","filePath":"platforms/core-runtime/client-services/src/main/java/org/gradle/launcher/daemon/toolchain/DaemonJavaToolchainProvisioningService.java","lineNumber":121,"sourceCode":"                    fileLock.close();\n                }\n            } catch (Exception e) {\n                progressLogger.completed(\"Failed to installed toolchain\", true);\n                throw new ToolchainDownloadException(spec, uri, e);\n            }\n        }\n    }\n\n    private URI getBuildPlatformToolchainUrl(JavaToolchainSpec spec) {\n        String stringUri = toolchainDownloadUrlProvider.getToolchainDownloadUrlByPlatform().get(buildPlatform.toBuildPlatform());\n        try {\n            return new URI(stringUri);\n        } catch (NullPointerException e) {\n            String cause = String.format(\"No defined toolchain download url for %s on %s architecture.\", buildPlatform.getOperatingSystem(), buildPlatform.getArchitecture().toString().toLowerCase(Locale.ROOT));\n            throw new ToolchainDownloadException(spec, stringUri, cause);\n        } catch (URISyntaxException e) {\n            String cause =  String.format(\"Invalid toolchain download url %s for %s on %s architecture.\", stringUri, buildPlatform.getOperatingSystem(), buildPlatform.getArchitecture().toString().toLowerCase(Locale.ROOT));\n            throw new ToolchainDownloadException(spec, stringUri, cause);\n        }\n    }\n}\n","sourceCodeStart":103,"sourceCodeEnd":125,"githubUrl":"https://github.com/gradle/gradle/blob/534f27719b66953f95cc907aae7f2c1b12f5482d/platforms/core-runtime/client-services/src/main/java/org/gradle/launcher/daemon/toolchain/DaemonJavaToolchainProvisioningService.java#L103-L125","documentation":"Error \"Unable to download toolchain matching the requirements ({}) from '{}', due to: Invalid toolchain download url {} for {} on {} architecture.\" thrown in gradle/gradle.","triggerScenarios":"The toolchain resolver returned a download URL that is malformed or not usable.","commonSituations":"Custom toolchain resolver plugins producing incorrect URLs; misconfigured mirror or repository templates.","solutions":["Fix the toolchain download URL template configured in your toolchain resolver plugin.","Use a maintained resolver plugin (e.g. Foojay) instead of a custom URL mapping.","Install the required JDK manually and disable auto-download via org.gradle.java.installations.auto-download=false."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"534f27719b66953f95cc907aae7f2c1b12f5482d","analyzedAt":"2026-08-22T08:09:12.375Z","schemaVersion":2},"datasetVersion":"2026-08-22T09:17:25.309Z"}