{"record":{"id":"56801eea65927bf3","repo":"quarkusio/quarkus","slug":"failed-to-initialize-quarkus-maven-extension-manag","errorCode":null,"errorMessage":"Failed to initialize Quarkus Maven extension manager","messagePattern":"Failed to initialize Quarkus Maven extension manager","errorType":"exception","errorClass":"MojoExecutionException","httpStatus":null,"severity":"error","filePath":"devtools/maven/src/main/java/io/quarkus/maven/QuarkusProjectMojoBase.java","lineNumber":106,"sourceCode":"        // Validate Mojo parameters\n        validateParameters();\n\n        final Path projectDirPath = baseDir();\n        BuildTool buildTool = QuarkusProject.resolveExistingProjectBuildTool(projectDirPath);\n        if (buildTool == null) {\n            // it's not Gradle and the pom.xml not found, so we assume there is no project at all\n            buildTool = BuildTool.MAVEN;\n        }\n\n        final QuarkusProject quarkusProject;\n        if (BuildTool.MAVEN.equals(buildTool) && project.getFile() != null && bomVersion == null) {\n            try {\n                quarkusProject = MavenProjectBuildFile.getProject(projectArtifact(), project.getOriginalModel(), baseDir(),\n                        project.getModel().getProperties(), artifactResolver(), getExtensionCatalogResolver(),\n                        getMessageWriter(),\n                        null);\n            } catch (RegistryResolutionException e) {\n                throw new MojoExecutionException(\"Failed to initialize Quarkus Maven extension manager\", e);\n            }\n        } else {\n            final ExtensionCatalog extensionCatalog = resolveExtensionCatalog();\n            final List<ResourceLoader> codestartsResourceLoader = CodestartResourceLoadersBuilder\n                    .codestartLoadersBuilder(log)\n                    .artifactResolver(artifactResolver())\n                    .catalog(extensionCatalog)\n                    .build();\n            quarkusProject = QuarkusProject.of(baseDir(), extensionCatalog,\n                    codestartsResourceLoader, log, buildTool,\n                    MavenProjectBuildFile.resolveJavaVersion(project.getModel().getProperties()));\n        }\n\n        doExecute(quarkusProject, getMessageWriter());\n    }\n\n    protected MessageWriter getMessageWriter() {\n        return log == null ? log = new MojoMessageWriter(getLog()) : log;","sourceCodeStart":88,"sourceCodeEnd":124,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/devtools/maven/src/main/java/io/quarkus/maven/QuarkusProjectMojoBase.java#L88-L124","documentation":"The Quarkus Maven plugin initializes the Quarkus project model (MavenProjectBuildFile) which may need to resolve the extension registry. When registry resolution fails with a RegistryResolutionException, the plugin wraps it in this MojoExecutionException, meaning the Quarkus extension manager could not be initialized.","triggerScenarios":"Executing a Quarkus MoJo (execute in QuarkusProjectMojoBase) where MavenProjectBuildFile.getProject requires resolving remote Quarkus registries and the resolution fails (network error, unreachable/bad registry URL, corrupt local registry cache).","commonSituations":"No network access or behind a proxy blocking registry.quarkus.io; misconfigured quarkus.registry entries in .quarkus/config.yaml or Maven settings; a registry URL pointing to a non-existent host; corrupted local registry cache in ~/.quarkus.","solutions":["Check network connectivity / proxy settings so the Quarkus registry (registry.quarkus.io) is reachable","Review registry configuration (quarkus.registry endpoints in .quarkus/config.yaml) for typos or invalid URLs","Refresh or delete the stale local registry cache (~/.quarkus) and retry","Inspect the underlying RegistryResolutionException (cause) for the exact host/reason that failed"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"// pre-check registry reachability before running the goal\ntry (var s = new Socket()) {\n    s.connect(new InetSocketAddress(\"registry.quarkus.io\", 443), 5000);\n} catch (IOException e) {\n    System.err.println(\"Quarkus registry unreachable; check network/proxy before running\");\n}","typeGuard":null,"tryCatchPattern":"try {\n    mojo.execute();\n} catch (MojoExecutionException e) {\n    if (e.getMessage().equals(\"Failed to initialize Quarkus Maven extension manager\") && e.getCause() instanceof RegistryResolutionException) {\n        // check network/proxy and registry config, clear ~/.quarkus cache, retry\n    } else {\n        throw e;\n    }\n}","preventionTips":["Ensure registry.quarkus.io is reachable from CI and dev environments (proxy/VPN settings)","Keep quarkus.registry configuration valid in .quarkus/config.yaml","Refresh or clear the local registry cache when upgrading Quarkus versions"],"tags":["maven","registry","network","quarkus"],"backgroundTag":"registry-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"}