タイトル: invalid LOC header (bad signature)
SEOタイトル: Maven「invalid LOC header (bad signature)」原因と対処｜~/.m2 キャッシュ破損
| この記事の要点 |
|
エラー内容
Maven プロジェクトをビルドするとき、または Tomcat 起動時に以下のエラーが出ます:
[ERROR] Failed to execute goal on project myapp:
Could not resolve dependencies for project com.example:myapp:war:1.0:
invalid LOC header (bad signature)
# または
java.util.zip.ZipException: invalid LOC header (bad signature)
at java.base/java.util.zip.ZipFile$Source.zerror(ZipFile.java:nnn)
at java.base/java.util.zip.ZipFile$Source.<init>(ZipFile.java:nnn)原因
~/.m2/repository 配下にキャッシュされた jar ファイルが破損しているのが原因です。jar は ZIP 形式で、LOC = Local file header signature の破損は ZIP として読めない状態を意味します。
発生する典型シーン:
- Maven の初回 / 大量ダウンロード時にネットワーク切断
- VPN や社内プロキシ経由で不完全な jarがキャッシュされた
- ディスク容量不足でダウンロードが中断
- 並行ビルド（複数の Maven 同時実行）でキャッシュ書き込み競合
- ウイルス対策ソフトの隔離で jar が中途半端な状態
対処1: 該当ライブラリだけ削除（推奨）
エラーメッセージで特定の jar が示唆されている場合、そこだけ削除:
# スタックトレースから問題の jar を特定
# 例: spring-core-5.3.20.jar が壊れている場合
# ライブラリのフォルダを削除
rm -rf ~/.m2/repository/org/springframework/spring-core/5.3.20/
# Windows
rmdir /S /Q "%USERPROFILE%\.m2\repository\org\springframework\spring-core\5.3.20"
# 再ダウンロード
mvn install
# または
mvn dependency:resolve対処2: -U オプションで強制更新
# Maven 標準の強制更新オプション
mvn clean install -U
# -U は --update-snapshots の短縮形
# SNAPSHOT 依存だけでなく、リリース版もチェックし直す対処3: ローカルリポジトリ全削除（最終手段）
どの jar が壊れているか分からない・複数破損している場合:
# ★ 注意: 数 GB のダウンロードが発生する
# バックアップしたければ移動: mv ~/.m2/repository ~/.m2/repository.bak
# 削除
rm -rf ~/.m2/repository
# Windows
rmdir /S /Q "%USERPROFILE%\.m2\repository"
# 再ビルドで自動ダウンロード
mvn clean install対処4: settings.xml でミラー設定
頻繁に破損する場合、ネットワーク経路に問題がある可能性。安定したミラーを設定:
<!-- ~/.m2/settings.xml -->
<settings>
<mirrors>
<mirror>
<id>aliyun-mirror</id>
<name>Aliyun Public Maven Mirror</name>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
<!-- プロキシが必要な場合 -->
<proxies>
<proxy>
<id>my-proxy</id>
<active>true</active>
<protocol>http</protocol>
<host>proxy.example.com</host>
<port>8080</port>
<username>user</username>
<password>pass</password>
<nonProxyHosts>localhost|127.0.0.1|*.example.com</nonProxyHosts>
</proxy>
</proxies>
</settings>破損ファイルを一括検出するスクリプト
# ~/.m2 配下のすべての jar が読めるかチェック
cd ~/.m2/repository
find . -name "*.jar" -print0 | while IFS= read -r -d '' jar; do
if ! unzip -tq "$jar" > /dev/null 2>&1; then
echo "BROKEN: $jar"
rm -f "$jar"
fi
done
# 破損したものを削除した後で再ビルド
cd /path/to/project
mvn install関連エラー
| エラー | 原因 |
|---|---|
| invalid LOC header (bad signature) | jar ZIP 構造破損 |
| Could not find artifact | jar 自体が存在しない（依存定義ミス / リポジトリ消滅） |
| error in opening zip file | 類似。jar 読み込み失敗 |
| Could not transfer artifact | ネットワーク到達不能 / プロキシ設定 |
| PKIX path building failed | SSL 証明書エラー（社内 CA 未インストール等） |
予防
- 安定回線でビルド — 初回ビルドや大規模依存追加時は特に
- 並行 Maven 実行を避ける — IDE と CLI で同時にビルドしない
- Nexus / Artifactory をチーム内に立てて社内ミラー化
- ローカル CI でも同じローカル M2 を使い回すなら排他制御
- Docker ビルド時はマウントで永続化するか毎回新規ダウンロード