quarkusio/quarkus · error · RuntimeException

Failed to resolve descriptor for ${projectArtifact}

Error message

Failed to resolve descriptor for ${projectArtifact}

What it means

RuntimeException from MavenProjectBuildFile.describe: reading the Maven artifact descriptor (effective pom/dependency info) of the project artifact failed during dependency analysis in devtools. The project artifact is interpolated into the message; the cause chain identifies the unresolvable dependency or repository problem.

Source

Thrown at independent-projects/tools/devtools-common/src/main/java/io/quarkus/devtools/project/buildfile/MavenProjectBuildFile.java:180

        }
        return null;
    }

    private static List<ArtifactCoords> toArtifactCoords(List<org.eclipse.aether.graph.Dependency> deps) {
        final List<ArtifactCoords> result = new ArrayList<>(deps.size());
        for (org.eclipse.aether.graph.Dependency dep : deps) {
            org.eclipse.aether.artifact.Artifact a = dep.getArtifact();
            result.add(ArtifactCoords.of(a.getGroupId(), a.getArtifactId(), a.getClassifier(),
                    a.getExtension(), a.getVersion()));
        }
        return result;
    }

    private static ArtifactDescriptorResult describe(MavenArtifactResolver resolver, Artifact projectArtifact) {
        try {
            return resolver.resolveDescriptor(projectArtifact);
        } catch (BootstrapMavenException e) {
            throw new RuntimeException("Failed to resolve descriptor for " + projectArtifact, e);
        }
    }

    private static List<ArtifactCoords> collectPlatformDescriptors(List<ArtifactCoords> managedDeps, MessageWriter log) {
        if (managedDeps.isEmpty()) {
            return Collections.emptyList();
        }
        final List<ArtifactCoords> result = new ArrayList<>(4);
        for (ArtifactCoords c : managedDeps) {
            if (PlatformArtifacts.isCatalogArtifact(c)) {
                result.add(c);
            }
        }
        return result;
    }

    private static boolean isSameFile(Path p1, Path p2) {
        try {

View on GitHub (pinned to e1c734241f)

Solutions

  1. Follow the caused-by exception to the unresolvable artifact
  2. Verify the artifact and its dependencies are deployed/installed in accessible repositories
  3. Retry after fixing settings or repository access if the cause is connectivity
Defensive patterns

Strategy: try-catch

When it happens

Trigger: Thrown at independent-projects/tools/devtools-common/src/main/java/io/quarkus/devtools/project/buildfile/MavenProjectBuildFile.java:180 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of quarkusio/quarkus@e1c734241f (2026-09-05). Data as JSON: /api/errors/eb3b2120805ee55a. Report an issue: GitHub.