{"record":{"id":"6b7495c42573b613","repo":"apache/maven","slug":"the-super-pom-resource-is-damaged-please-verify","errorCode":null,"errorMessage":"The super POM {resource} is damaged, please verify the integrity of your Maven installation","messagePattern":"The super POM (.+?) is damaged, 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":82,"sourceCode":"            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\"\n                                + \", please verify the integrity of your Maven installation\",\n                        e);\n            }\n        }\n\n        return superModel;\n    }\n\n    static String getImplementationVersion(Class<?> clazz) {\n        Package packageInfo = clazz.getPackage();\n        return packageInfo != null ? packageInfo.getImplementationVersion() : null;\n    }\n}\n","sourceCodeStart":64,"sourceCodeEnd":97,"githubUrl":"https://github.com/apache/maven/blob/e4093d4e120eac99d6bdce5ba67cace2f3085c97/compat/maven-model-builder/src/main/java/org/apache/maven/model/superpom/DefaultSuperPomProvider.java#L64-L97","documentation":"The super POM classpath resource was found, but reading or parsing it threw an IOException, wrapped in IllegalStateException saying the super POM 'is damaged'. This is never a POM-authoring problem: the bundled super POM inside maven-model-builder could not be read, which almost always means physical corruption of the installation.","triggerScenarios":"modelProcessor.read(is, options) on the bundled super-POM stream fails: truncated or corrupted jar entry, broken zip structure, or a jar swapped mid-run.","commonSituations":"Interrupted Maven download or install; disk or archive corruption; a truncated maven-model-builder jar on the classpath; antivirus quarantining parts of the jar.","solutions":["Re-download or replace the maven-model-builder jar and reinstall the Maven distribution","Verify integrity: compare the jar's checksum against the published one on Maven Central","Re-provision the whole installation (with the wrapper: distributionUrl in .mvn/wrapper/maven-wrapper.properties)","Investigate disk or antivirus interference if corruption recurs"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"try {\n    Model superModel = superPomProvider.getSuperModel(modelVersion);\n} catch (IllegalStateException e) {\n    if (e.getMessage() != null && e.getMessage().contains(\"is damaged\")) {\n        // installation-level corruption: re-provision, no point retrying as-is\n        throw new ProvisioningRequiredException(\"Reinstall Maven: bundled super POM unreadable\", e);\n    }\n    throw e;\n}","preventionTips":["Verify distribution and jar checksums during provisioning","Re-provision the Maven installation via the wrapper when integrity checks fail","Never hand-modify jars under the Maven home lib directory"],"tags":["maven","super-pom","installation","corruption","io"],"backgroundTag":"corrupted-installation","analyzedSha":"e4093d4e120eac99d6bdce5ba67cace2f3085c97","analyzedAt":"2026-08-21T22:58:24.034Z","schemaVersion":2},"datasetVersion":"2026-08-21T23:17:16.201Z"}