{"record":{"id":"ee7b7c217b622f0a","repo":"apache/maven","slug":"the-super-pom-resource-was-not-found-please-ver","errorCode":null,"errorMessage":"The super POM {resource} 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":"compat/maven-model-builder/src/main/java/org/apache/maven/model/superpom/DefaultSuperPomProvider.java","lineNumber":65,"sourceCode":"    private Model superModel;\n\n    @Inject\n    private ModelProcessor modelProcessor;\n\n    public DefaultSuperPomProvider setModelProcessor(ModelProcessor modelProcessor) {\n        this.modelProcessor = modelProcessor;\n        return this;\n    }\n\n    @Override\n    public Model getSuperModel(String version) {\n        if (superModel == null) {\n            String resource = \"/org/apache/maven/model/pom-\" + version + \".xml\";\n\n            InputStream is = getClass().getResourceAsStream(resource);\n\n            if (is == null) {\n                throw new IllegalStateException(\"The super POM \" + resource + \" was not found\"\n                        + \", please verify the integrity of your Maven installation\");\n            }\n\n            try {\n                Map<String, Object> options = new HashMap<>();\n                options.put(\"xml:4.0.0\", \"xml:4.0.0\");\n\n                String modelId =\n                        \"org.apache.maven:maven-model-builder:\" + getImplementationVersion(getClass()) + \":super-pom\";\n                InputSource inputSource = new InputSource();\n                inputSource.setModelId(modelId);\n                inputSource.setLocation(getClass().getResource(resource).toExternalForm());\n                options.put(ModelProcessor.INPUT_SOURCE, inputSource);\n\n                superModel = modelProcessor.read(is, options);\n            } catch (IOException e) {\n                throw new IllegalStateException(\n                        \"The super POM \" + resource + \" is damaged\"","sourceCodeStart":47,"sourceCodeEnd":83,"githubUrl":"https://github.com/apache/maven/blob/e4093d4e120eac99d6bdce5ba67cace2f3085c97/compat/maven-model-builder/src/main/java/org/apache/maven/model/superpom/DefaultSuperPomProvider.java#L47-L83","documentation":"DefaultSuperPomProvider loads the built-in super POM for a model version from the classpath resource /org/apache/maven/model/pom-<version>.xml. If that resource is absent, every model build for that version fails immediately with IllegalStateException: the message points at a broken or incompatible Maven installation rather than at the user's POM.","triggerScenarios":"getSuperModel(version) called with a modelVersion whose pom-<version>.xml is not shipped in the maven-model-builder jar (unsupported or typo'd modelVersion), or a jar that was corrupted, trimmed, or repackaged so the resource is missing.","commonSituations":"Corrupted or trimmed-down Maven distribution; a hand-crafted POM with a custom modelVersion; mixing a model-builder from one Maven line with model versions from another; shading/relocation dropping org/apache/maven/model resources.","solutions":["Verify the resource exists: unzip -l maven-model-builder-*.jar | grep 'pom-'; if absent, reinstall Maven or replace the jar from Maven Central","Fix the POM modelVersion to a supported value (e.g. 4.0.0)","Ensure no dependency shading or relocation strips org/apache/maven/model resources","Compare against a known-good installation of the same Maven version"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"// Verify the super POM resource exists for this modelVersion before building\nString resource = \"/org/apache/maven/model/pom-\" + modelVersion + \".xml\";\nif (DefaultSuperPomProvider.class.getResourceAsStream(resource) == null) {\n    throw new IllegalStateException(\n        \"modelVersion \" + modelVersion + \" not supported by this maven-model-builder; \"\n        + \"check installation integrity\");\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Install Maven from official distributions and verify archive checksums","Validate modelVersion against supported values before building models programmatically","Do not shade/relocate maven-model-builder; if unavoidable, keep org/apache/maven/model resources"],"tags":["maven","super-pom","classpath-resource","installation","corruption"],"backgroundTag":"missing-classpath-resource","analyzedSha":"e4093d4e120eac99d6bdce5ba67cace2f3085c97","analyzedAt":"2026-08-21T22:58:24.034Z","schemaVersion":2},"datasetVersion":"2026-08-21T23:17:16.201Z"}