{"record":{"id":"fe7f9b80bb765c85","repo":"quarkusio/quarkus","slug":"failed-to-initialize-maven-artifact-resolver-fe7f9b","errorCode":null,"errorMessage":"Failed to initialize Maven artifact resolver","messagePattern":"Failed to initialize Maven artifact resolver","errorType":"exception","errorClass":"MojoExecutionException","httpStatus":null,"severity":"error","filePath":"devtools/maven/src/main/java/io/quarkus/maven/CreateJBangMojo.java","lineNumber":103,"sourceCode":"            Files.createDirectories(outputDirectory.toPath());\n        } catch (IOException e) {\n            throw new MojoExecutionException(\"Could not create directory \" + outputDirectory, e);\n        }\n\n        File projectRoot = outputDirectory;\n        final Path projectDirPath = projectRoot.toPath();\n\n        final MavenArtifactResolver mvn;\n        try {\n            mvn = MavenArtifactResolver.builder()\n                    .setRepositorySystem(repoSystem)\n                    .setRepositorySystemSession(\n                            getLog().isDebugEnabled() ? repoSession : MojoUtils.muteTransferListener(repoSession))\n                    .setRemoteRepositories(repos)\n                    .setRemoteRepositoryManager(remoteRepoManager)\n                    .build();\n        } catch (Exception e) {\n            throw new MojoExecutionException(\"Failed to initialize Maven artifact resolver\", e);\n        }\n\n        final MessageWriter log = new MojoMessageWriter(getLog());\n        ExtensionCatalog catalog;\n        try {\n            catalog = CreateProjectMojo.resolveExtensionsCatalog(this, bomGroupId, bomArtifactId, bomVersion, null,\n                    QuarkusProjectHelper.getCatalogResolver(mvn, log), mvn, log);\n        } catch (RegistryResolutionException e) {\n            throw new MojoExecutionException(\"Failed to resolve Quarkus extension catalog\", e);\n        }\n\n        final List<ResourceLoader> codestartsResourceLoader = codestartLoadersBuilder(log)\n                .catalog(catalog)\n                .artifactResolver(mvn)\n                .build();\n        final CreateJBangProject createJBangProject = new CreateJBangProject(QuarkusProject.of(projectDirPath, catalog,\n                codestartsResourceLoader, log, BuildTool.MAVEN, new JavaVersion(javaVersion)))\n                .extensions(extensions)","sourceCodeStart":85,"sourceCodeEnd":121,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/devtools/maven/src/main/java/io/quarkus/maven/CreateJBangMojo.java#L85-L121","documentation":"Same pattern as [410]: building the MavenArtifactResolver for the create-jbang goal failed and is wrapped in MojoExecutionException. The resolver is needed to download the Quarkus BOM and extension catalog used to scaffold the JBang project.","triggerScenarios":"MavenArtifactResolver.builder()...build() (with remote repos/remoteRepositoryManager, transfer listener muted unless debug) throws any Exception in CreateJBangMojo.execute().","commonSituations":"Invalid quarkus.platform.* coordinates misconfiguring repositories, settings.xml proxy/mirror failures, unreachable Maven Central, corrupted local repository metadata.","solutions":["Rerun with -X and read the 'Caused by' to identify the actual resolver failure","Verify network access to the configured repositories (proxy/VPN/firewall)","Fix invalid mirrors/proxies/localRepository in ~/.m2/settings.xml","Check quarkus.platform.group-id/artifact-id/version properties are valid for your Quarkus version"],"exampleFix":"// before\nmvn quarkus:create-jbang  // fails behind corporate proxy\n// after\n// set proxy in ~/.m2/settings.xml, then\nmvn -X quarkus:create-jbang","handlingStrategy":"validation","validationCode":"// verify repository reachability before running\njava.net.http.HttpClient c = java.net.http.HttpClient.newHttpClient();\nvar resp = c.send(java.net.http.HttpRequest.newBuilder(java.net.URI.create(\"https://repo.maven.apache.org/maven2/\")).method(\"HEAD\", java.net.http.HttpRequest.BodyPublishers.noBody()).build(), java.net.http.HttpResponse.BodyHandlers.discarding());\nif (resp.statusCode() >= 400) throw new IllegalStateException(\"Maven Central unreachable: \" + resp.statusCode());","typeGuard":null,"tryCatchPattern":"try {\n    mvn quarkus:create-jbang ...\n} catch (MojoExecutionException e) {\n    if (e.getMessage().contains(\"Failed to initialize Maven artifact resolver\")) {\n        Throwable root = e; while (root.getCause() != null) root = root.getCause();\n        logger.error(\"Resolver init failed: {} — check settings.xml mirrors/proxies\", root.getMessage());\n    }\n}","preventionTips":["Run mvn help:effective-settings to validate mirrors/proxies before generating","Ensure quarkus.platform.* properties match a published Quarkus version","Warm the local repo with a simple mvn dependency:resolve to catch network issues early"],"tags":["maven","artifact-resolver","network"],"backgroundTag":"maven-artifact-resolution-failed","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-12T22:17:10.623Z"}