Eclipseのビルドパスエラーを解決する — よくある問題と対処法

ビルドパスエラーが出る原因

プロジェクトに赤いバツ印（エラーマーク）が付いているとき、多くの場合はビルドパスの問題です。

Problems ビューを確認します: Window > Show View > Problems

よくあるエラーと解決方法

1. “Build path entry is missing”

Build path entry is missing: 'M2_REPO/...'

原因: Maven の依存関係がローカルリポジトリにない。

解決:

プロジェクト右クリック
  → Maven > Update Project
  → [x] Force Update of Snapshots/Releases
  → OK

または:

mvn dependency:resolve

2. “Unbound classpath variable”

Unbound classpath variable: 'M2_REPO'

原因: Maven リポジトリの場所が Eclipse に登録されていない。

解決:

Window > Preferences > Java > Build Path > Classpath Variables
  → New
  → Name: M2_REPO
  → Path: C:\Users\username\.m2\repository（適切なパス）

3. “The project cannot be built until build path errors are resolved”

根本的なビルドパスエラーが別にあります。Problems ビューで最初のエラーを先に解決します。

4. JREのバージョン不一致

Java compiler level does not match the version of the installed Java project facet

解決:

プロジェクト右クリック → Properties
  → Java Compiler > Compiler compliance level: 17（使用するバージョン）
  → Java Build Path > Libraries タブ
  → JRE System Library をダブルクリック
  → 正しいJREを選択

または pom.xml の設定を確認:

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

5. 外部JARが見つからない

The container 'Web App Libraries' references non existing library

解決: JAR ファイルを正しい場所に配置し、ビルドパスに追加:

プロジェクト右クリック → Build Path → Configure Build Path
  → Libraries タブ → Add External JARs
  → JARファイルを選択

6. 循環参照エラー

A cycle was detected in the build path of project ...

解決:

Window > Preferences > Java > Compiler
  → Building > Circular dependencies: Warning（またはIgnore）に変更

根本的な解決はプロジェクト間の依存関係を整理することです。

プロジェクトのクリーンビルド

多くのエラーはクリーンビルドで解消します:

Project > Clean > [x] Clean all projects > OK

.classpath ファイルの直接確認

.classpath ファイル（プロジェクトルートに隠しファイルとして存在）をテキストエディタで開き、存在しないパスを削除します。

<?xml version="1.0" encoding="UTF-8"?>
<classpath>
    <classpathentry kind="src" path="src/main/java"/>
    <classpathentry kind="src" path="src/test/java"/>
    <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/..."/>
    <classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER"/>
    <classpathentry kind="output" path="target/classes"/>
</classpath>

インストール済みJREの確認と追加

Window > Preferences > Java > Installed JREs

JDK が表示されていない場合は Add > Standard VM > JDK のホームディレクトリ で追加。

java.home でJDKのパスを確認:

java -XshowSettings:all -version 2>&1 | grep java.home

Maven プロジェクトの再インポート

完全に壊れた場合は再インポートが確実です:

プロジェクトを削除（Delete project contents on disk は チェックしない）
File > Import > Maven > Existing Maven Projects
プロジェクトフォルダを選択して Finish

まとめ

エラー	まず試すこと
依存関係が見つからない	`Maven > Update Project`
JRE の不一致	`Properties > Java Compiler`
謎のビルドエラー	`Project > Clean`
完全に壊れた	プロジェクトを削除して再インポート

ビルドパスのエラーは怖く見えますが、ほとんどは「依存関係の再解決」か「クリーンビルド」で直ります。

S	公式ソース確認済み
A	成功実績多数・失敗例少数
B	賛否両論
C	動作未確認・セキュリティリスク高
Z	個人所感