apache/maven · error · ChecksumFailedException

Invalid checksum file

Error message

Invalid checksum file

What it means

Error "Invalid checksum file" thrown in apache/maven.

Source

Thrown at compat/maven-compat/src/main/java/org/apache/maven/repository/legacy/DefaultWagonManager.java:661

                File checksumFile = new File(destination + checksumFileExtension);
                if (checksumFile.exists()) {
                    checksumFile.delete(); // ignore if failed as we will overwrite
                }
                Files.copy(
                        tempChecksumFile.toPath(),
                        checksumFile.toPath(),
                        StandardCopyOption.REPLACE_EXISTING,
                        StandardCopyOption.COPY_ATTRIBUTES);

                if (!tempChecksumFile.delete()) {
                    tempChecksumFile.deleteOnExit();
                }
            } else {
                throw new ChecksumFailedException("Checksum failed on download: local = '" + actualChecksum
                        + "'; remote = '" + expectedChecksum + "'");
            }
        } catch (IOException e) {
            throw new ChecksumFailedException("Invalid checksum file", e);
        }
    }

    private void disconnectWagon(Wagon wagon) {
        try {
            wagon.disconnect();
        } catch (ConnectionException e) {
            logger.error("Problem disconnecting from wagon - ignoring: " + e.getMessage());
        }
    }

    private void releaseWagon(String protocol, Wagon wagon) {
        try {
            container.release(wagon);
        } catch (ComponentLifecycleException e) {
            logger.error("Problem releasing wagon - ignoring: " + e.getMessage());
            logger.debug("", e);
        }

View on GitHub (pinned to e4093d4e12)

When it happens

Trigger: Thrown at compat/maven-compat/src/main/java/org/apache/maven/repository/legacy/DefaultWagonManager.java:661 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/maven@e4093d4e12 (2026-08-21). Data as JSON: /api/errors/3384740000fcbcf2. Report an issue: GitHub.