{"record":{"id":"dc4c713aea136626","repo":"quarkusio/quarkus","slug":"failed-to-generate-jbang-quarkus-project","errorCode":null,"errorMessage":"Failed to generate JBang Quarkus project","messagePattern":"Failed to generate JBang Quarkus project","errorType":"exception","errorClass":"MojoExecutionException","httpStatus":null,"severity":"error","filePath":"devtools/maven/src/main/java/io/quarkus/maven/CreateJBangMojo.java","lineNumber":130,"sourceCode":"            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)\n                .javaVersion(javaVersion)\n                .setValue(NO_JBANG_WRAPPER, noJBangWrapper);\n\n        boolean success;\n\n        try {\n            success = createJBangProject.execute().isSuccess();\n        } catch (QuarkusCommandException e) {\n            throw new MojoExecutionException(\"Failed to generate JBang Quarkus project\", e);\n        }\n\n        if (success) {\n            getLog().info(\"\");\n            getLog().info(\"========================================================================\");\n            getLog().warn(\"Quarkus JBang project is an experimental feature.\");\n            getLog().info(\"========================================================================\");\n            getLog().info(\"\");\n        } else {\n            throw new MojoExecutionException(\n                    \"Failed to generate JBang Quarkus project\");\n        }\n    }\n}\n","sourceCodeStart":112,"sourceCodeEnd":145,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/devtools/maven/src/main/java/io/quarkus/maven/CreateJBangMojo.java#L112-L145","documentation":"Wraps a QuarkusCommandException from CreateJBangProject.execute() into a MojoExecutionException. The JBang project generation command threw while rendering templates or writing the project, aborting the quarkus:create-jbang goal.","triggerScenarios":"createJBangProject.execute() throws QuarkusCommandException — template loading/rendering failures, codestart application errors, or I/O errors writing into outputDirectory.","commonSituations":"Read-only or partially populated outputDirectory, corrupt local Quarkus artifacts breaking codestart resource loading, plugin jar corruption, name/namespace conflicts with pre-existing files.","solutions":["Read the chained QuarkusCommandException stack trace (-e/-X) for the concrete failure","Run against a clean, empty, writable outputDirectory","Delete suspicious artifacts under ~/.m2/repository/io/quarkus and re-resolve","Update the Quarkus Maven plugin to the latest patch version"],"exampleFix":"// before\nmvn quarkus:create-jbang -DoutputDirectory=./existing-app  // conflicts\n// after\nmvn quarkus:create-jbang -DoutputDirectory=./my-new-jbang-app","handlingStrategy":"try-catch","validationCode":"java.nio.file.Path out = java.nio.file.Path.of(outputDirectory);\nif (java.nio.file.Files.exists(out) && java.nio.file.Files.list(out).findAny().isPresent())\n    logger.warn(\"outputDirectory is not empty; generation may fail\");","typeGuard":null,"tryCatchPattern":"try {\n    mvn quarkus:create-jbang ...\n} catch (MojoExecutionException e) {\n    if (e.getCause() != null) {\n        logger.error(\"JBang generation threw: {}\", e.getCause().getMessage(), e); // fix root cause, rerun clean\n    }\n}","preventionTips":["Generate into a clean, empty, writable directory","Keep Quarkus Maven plugin and platform versions aligned","Clear ~/.m2/repository/io/quarkus entries if codestart resource loading errors appear"],"tags":["maven","project-generation","jbang"],"backgroundTag":"project-generation-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"}