apache/maven · error · ChecksumFailedException

Checksum failed on download: local = '" + actualChecksum + "

Error message

Checksum failed on download: local = '" + actualChecksum + "'; remote = '" + expectedChecksum + "'

What it means

Error "Checksum failed on download: local = '" + actualChecksum + "'; remote = '" + expectedChecksum + "'" thrown in apache/maven.

Source

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

                    expectedChecksum = expectedChecksum.substring(0, spacePos);
                }
            }
            if (expectedChecksum.equalsIgnoreCase(actualChecksum)) {
                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);

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:657 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/4d9c8b231ccf98eb. Report an issue: GitHub.