{"record":{"id":"462d97a5cd50903d","repo":"apache/maven","slug":"the-super-pom-was-not-found-please-verify-the","errorCode":null,"errorMessage":"The super POM {} was not found, please verify the integrity of your Maven installation","messagePattern":"The super POM (.+?) was not found, please verify the integrity of your Maven installation","errorType":"exception","errorClass":"IllegalStateException","httpStatus":null,"severity":"critical","filePath":"impl/maven-impl/src/main/java/org/apache/maven/impl/DefaultSuperPomProvider.java","lineNumber":61,"sourceCode":"     * The cached super POM, lazily created.\n     */\n    private static final Map<String, Model> SUPER_MODELS = new ConcurrentHashMap<>();\n\n    @Inject\n    public DefaultSuperPomProvider(ModelProcessor modelProcessor) {\n        this.modelProcessor = modelProcessor;\n    }\n\n    @Override\n    public Model getSuperPom(String version) {\n        return SUPER_MODELS.computeIfAbsent(Objects.requireNonNull(version), v -> readModel(version, v));\n    }\n\n    private Model readModel(String version, String v) {\n        String resource = \"/org/apache/maven/model/pom-\" + v + \".xml\";\n        URL url = getClass().getResource(resource);\n        if (url == null) {\n            throw new IllegalStateException(\"The super POM \" + resource + \" was not found\"\n                    + \", please verify the integrity of your Maven installation\");\n        }\n        try (InputStream is = url.openStream()) {\n            String modelId =\n                    \"org.apache.maven:maven-api-impl:\" + getImplementationVersion(getClass()) + \":super-pom-\" + version;\n            return modelProcessor.read(XmlReaderRequest.builder()\n                    .modelId(modelId)\n                    .location(url.toExternalForm())\n                    .inputStream(is)\n                    .strict(false)\n                    .build());\n        } catch (IOException e) {\n            throw new IllegalStateException(\n                    \"The super POM \" + resource + \" is damaged\"\n                            + \", please verify the integrity of your Maven installation\",\n                    e);\n        }\n    }","sourceCodeStart":43,"sourceCodeEnd":79,"githubUrl":"https://github.com/apache/maven/blob/e4093d4e120eac99d6bdce5ba67cace2f3085c97/impl/maven-impl/src/main/java/org/apache/maven/impl/DefaultSuperPomProvider.java#L43-L79","documentation":"Maven loads the super POM (the implicit parent of every model) from the classpath resource /org/apache/maven/model/pom-<version>.xml shipped inside the maven-impl artifact. If the resource is absent, DefaultSuperPomProvider throws IllegalStateException: the running installation is incomplete or its classpath mixes incompatible artifacts. The message asks the user to verify the integrity of the Maven installation.","triggerScenarios":"Model building calls getSuperPom(version) and the jar containing DefaultSuperPomProvider lacks a pom-<version>.xml for the requested model version: broken installation, shaded or pruned jar, or a conflicting older maven-impl winning on the classpath.","commonSituations":"Corrupted Maven distribution; applications embedding Maven with dependency conflicts on maven-impl; custom assemblies that strip resource files; building a model whose modelVersion has no super POM in the running Maven version.","solutions":["Inspect the maven-impl jar: unzip -l maven-impl-*.jar | grep 'pom-.*\\\\.xml' and confirm the needed version is present","Resolve classpath conflicts (mvn dependency:tree | grep maven-impl) so only the matching version loads","Reinstall or repair the Maven distribution if its jar is missing resources","In embedded setups, pin one maven-impl version explicitly"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"String modelVersion = \"4.0.0\";\nURL superPom = getClass().getResource(\"/org/apache/maven/model/pom-\" + modelVersion + \".xml\");\nif (superPom == null) {\n    throw new IllegalStateException(\n        \"Maven installation has no super POM for model \" + modelVersion\n        + \"; fix maven-impl on the classpath\");\n}\n// safe to build models","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Pin a single maven-impl version in embedded-Maven dependency management","Run a smoke model build after assembling a custom Maven distribution","Check mvn dependency:tree for maven-impl conflicts before shipping"],"tags":["maven","super-pom","classpath","installation"],"backgroundTag":"missing-classpath-resource","analyzedSha":"e4093d4e120eac99d6bdce5ba67cace2f3085c97","analyzedAt":"2026-08-21T22:58:24.034Z","schemaVersion":2},"datasetVersion":"2026-08-21T23:17:16.201Z"}