{"record":{"id":"29a71778ddcc3110","repo":"quarkusio/quarkus","slug":"unable-to-list-extensions","errorCode":null,"errorMessage":"Unable to list extensions","messagePattern":"Unable to list extensions","errorType":"exception","errorClass":"GradleException","httpStatus":null,"severity":"error","filePath":"devtools/gradle/gradle-application-plugin/src/main/java/io/quarkus/gradle/tasks/QuarkusListExtensions.java","lineNumber":124,"sourceCode":"\n            if (!fromCli) {\n                GradleMessageWriter log = messageWriter();\n                if (DEFAULT_FORMAT.equalsIgnoreCase(format)) {\n                    log.info(\"\");\n                    log.info(ListExtensions.MORE_INFO_HINT, \"--format=full\");\n                }\n\n                if (!installed && (category == null || category.isBlank())) {\n                    log.info(\"\");\n                    log.info(ListExtensions.FILTER_HINT, \"--category=\\\"categoryId\\\"\");\n                }\n\n                log.info(\"\");\n                log.info(ListExtensions.ADD_EXTENSION_HINT,\n                        \"build.gradle\", \"./gradlew addExtension --extensions=\\\"artifactId\\\"\");\n            }\n        } catch (Exception e) {\n            throw new GradleException(\"Unable to list extensions\", e);\n        }\n    }\n}\n","sourceCodeStart":106,"sourceCodeEnd":128,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/devtools/gradle/gradle-application-plugin/src/main/java/io/quarkus/gradle/tasks/QuarkusListExtensions.java#L106-L128","documentation":"The QuarkusListExtensions Gradle task (./gradlew listExtensions) resolves the extension catalog and lists installed/available Quarkus extensions. Any Exception during resolution or rendering is wrapped in this GradleException. It almost always indicates the extension catalog or platform could not be resolved from the configured registries.","triggerScenarios":"Running ./gradlew listExtensions when catalog/platform resolution throws: unreachable registry, invalid platform coordinates, or broken application model; raised in QuarkusListExtensions.listExtensions.","commonSituations":"No internet access or proxy-blocked registry.quarkus.io; incorrect or missing quarkus BOM/enforcedPlatform; version typos in the platform dependency; CI sandboxes without egress.","solutions":["Run with --stacktrace to inspect the wrapped root cause.","Verify network/proxy configuration for reaching registry.quarkus.io.","Ensure enforcedPlatform('io.quarkus.platform:quarkus-bom:<version>') is declared with a valid version.","Retry after clearing stale caches: ./gradlew --refresh-dependencies listExtensions.","Configure an internal mirror registry if operating behind a firewall."],"exampleFix":"// before: wrong platform version\nimplementation enforcedPlatform('io.quarkus.platform:quarkus-bom:999-nonexistent')\n// after\nimplementation enforcedPlatform('io.quarkus.platform:quarkus-bom:3.15.0')","handlingStrategy":"retry","validationCode":"// Validate network + platform before listing extensions\ncurl -fsSL https://registry.quarkus.io/ > /dev/null && \\\ngrep -q \"enforcedPlatform('io.quarkus.platform:quarkus-bom:\" build.gradle && echo \"OK\" || echo \"registry or platform BOM missing\"","typeGuard":null,"tryCatchPattern":"try {\n  ./gradlew listExtensions\n} catch (GradleException e) {\n  if (e.getMessage().equals(\"Unable to list extensions\")) {\n    // check --stacktrace cause; fix network/proxy or BOM version, retry with --refresh-dependencies\n  }\n}","preventionTips":["Keep the quarkus-bom version current and correctly spelled.","Set proxy/firewall exceptions for registry.quarkus.io in CI.","Avoid --offline without a previously warmed catalog cache.","Pin platform versions instead of using dynamic versions like LATEST."],"tags":["gradle","network","extension-registry","quarkus-cli"],"backgroundTag":"extension-catalog-resolution-failed","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}