Checksum validation failed の原因と解決策

概要

Checksum validation failed は、Mavenがリモートリポジトリからダウンロードしたアーティファクトの整合性検証（SHA-1/MD5チェックサム）に失敗した場合に発生するエラーです。ダウンロードの途中切断、プロキシによる改変、リポジトリ側の不整合が原因です。

エラーメッセージ

[WARNING] Checksum validation failed, expected e52cedb3dba50c26877a6b3d88a08f98703d82a4
but is 2406c868ae24a7f15c78aa362346afd6ba44ec22

[ERROR] Could not validate integrity of download from
https://repo.maven.apache.org/maven2/org/example/library/1.0/library-1.0.jar

[WARNING] Could not validate integrity of download: Checksum validation failed,
no checksums available

原因

1. ダウンロードの途中切断

ネットワーク不安定によりファイルが不完全にダウンロードされ、ローカルキャッシュに破損ファイルが残る場合があります。

2. プロキシによるコンテンツ改変

企業プロキシがHTTPレスポンスを改変（エラーページの挿入等）する場合があります。

3. リポジトリ側のチェックサム不整合

リポジトリにアップロードされたアーティファクト自体のチェックサムが不正な場合があります。

4. ローカルキャッシュの破損

.m2/repository 内のファイルが何らかの原因で破損した場合があります。

解決策

1. ローカルキャッシュを削除して再ダウンロード

1
2
3
4
5
# 特定のアーティファクトを削除
rm -rf ~/.m2/repository/org/example/library

# 強制更新でビルド
mvn clean install -U

2. チェックサムポリシーを変更（一時的）

1
2
# チェックサムエラーを警告に変更して確認
mvn clean install -Daether.checksums.policy=warn

3. settings.xmlでチェックサムポリシーを設定

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
<!-- ~/.m2/settings.xml -->
<settings>
    <profiles>
        <profile>
            <id>checksum-policy</id>
            <repositories>
                <repository>
                    <id>central</id>
                    <url>https://repo.maven.apache.org/maven2</url>
                    <releases>
                        <checksumPolicy>warn</checksumPolicy>
                    </releases>
                </repository>
            </repositories>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>checksum-policy</activeProfile>
    </activeProfiles>
</settings>

4. ミラーリポジトリに切り替え

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<!-- ~/.m2/settings.xml -->
<settings>
    <mirrors>
        <mirror>
            <id>central-mirror</id>
            <mirrorOf>central</mirrorOf>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>
</settings>

5. ローカルリポジトリ全体をクリア

1
2
3
4
5
# 全キャッシュを削除（時間がかかる）
rm -rf ~/.m2/repository

# 依存関係を再ダウンロード
mvn dependency:resolve

デバッグ方法

1
2
3
4
5
# 詳細出力でチェックサム検証の状況を確認
mvn clean install -X | grep -i checksum

# 特定のアーティファクトのチェックサムを手動確認
sha1sum ~/.m2/repository/org/example/library/1.0/library-1.0.jar

Checksum validation failed

概要