Eclipseが起動しない・ワークスペースで止まるときの原因と対処法

Java

Eclipseを起動しようとしたら、スプラッシュ画面で止まる、ワークスペースの選択後に落ちる、「Workspace in use or cannot be created」エラーが出る——こうしたトラブルは、強制終了や予期せぬシャットダウンをきっかけに突然起きることが多いです。
この記事では、ワークスペース絡みのEclipse起動トラブルの主な原因と、データを守りながら試せる対処法を順番に解説します。

スポンサーリンク

よくあるエラーパターン

Eclipseの起動失敗には、いくつかの典型的な症状があります。
自分の症状がどれに当てはまるかを先に確認しておくと、対処法を絞り込みやすくなります。

症状主な原因の目安
スプラッシュ画面が途中で消える.snapファイル残留、メモリ不足、JVMエラー
「Workspace in use or cannot be created」エラー.lockファイルが残っている
ワークスペース選択後に止まる・ハングするworkbench.xmiの破損、スレッドデッドロック
「An error has occurred. See the log file…」.metadataの破損
特定のワークスペースだけ開けないworkbench.xmiまたは.snapファイルの問題

原因と対処法

⚠️ 重要：作業前に必ずワークスペースフォルダとconfigurationフォルダをバックアップしてください。
ファイルを削除する操作は元に戻せません。

対処法1：まずログを確認する

どの対処法を試す前に、まずエラーログを確認して原因を絞り込みましょう。
ログファイルは以下の場所にあります。

[ワークスペースのパス]/.metadata/.log

ログに出ているエラーメッセージを確認することで、どの対処法が有効かを判断しやすくなります。
!MESSAGE The workspace exited with unsaved changes in the previous session のような記述があれば、.snapファイルの削除（対処法3）が有効です。

対処法2：-cleanオプション付きで起動する

強制終了後の起動不良の多くは、-cleanオプション起動で解決します。
これはEclipseのキャッシュをクリアして再構築する起動方法です。

Windowsの場合、コマンドプロンプトで以下を実行します。

eclipse.exe -clean

Pleiadesを使用している場合は eclipse.exe ではなく eclipsec.exe を使うとエラーメッセージをコマンドライン上で確認できます。

eclipsec.exe -clean

macOS / Linuxの場合は以下のように実行します。

./eclipse -clean

注意：-clean起動は初回や環境によって数分かかる場合があります。
ウィンドウが表示されない間も処理が続いていることがあるので、しばらく待ってから判断してください。

対処法3：.lockファイルを削除する（「Workspace in use」エラーの場合）

Workspace in use or cannot be created というエラーが出る場合、前回のEclipseプロセスが正常に終了せず、ワークスペースのロックファイルが残っているのが原因です。

削除するファイルは以下のパスにある .lock ファイルです。

[ワークスペースのパス]/.metadata/.lock

手順：

  1. タスクマネージャー（Windowsの場合）またはアクティビティモニター（macOSの場合）で eclipse.exe および javaw.exe（または java）のプロセスがすべて終了していることを確認する
  2. 上記パスの .lock ファイルを削除する
  3. Eclipseを再起動する

Windowsで「eclipse.exeが使用中」と表示されて削除できない場合は、タスクマネージャーのプロセスタブから eclipse.exe と javaw.exe を終了してから削除してください。

注意：.metadataフォルダ自体は削除しないでください。
.metadataフォルダにはEclipseの設定情報がすべて含まれており、削除するとワークスペースの設定がリセットされます。

対処法4：.snapファイルを削除する（強制終了後の起動失敗の場合）

フリーズや急なシャットダウンの後でEclipseが起動しなくなった場合、未保存セッションの.snapファイルが残っていることが原因のケースが多いです。
ログに The workspace exited with unsaved changes in the previous session と記録されていれば、このケースに該当します。

削除対象のファイルは以下の3つです。

[ワークスペース]/.metadata/.plugins/org.eclipse.core.resources/.snap
[ワークスペース]/.metadata/.plugins/org.eclipse.core.resources/.projects/[プロジェクト名]/.markers.snap
[ワークスペース]/.metadata/.plugins/org.eclipse.core.resources/.projects/[プロジェクト名]/.syncinfo.snap

複数のプロジェクトが含まれる場合は、直前に使っていたプロジェクト、または全プロジェクトの.snapファイルを削除してから再起動します。

対処法5：workbench.xmiを削除する（特定のワークスペースだけ開けない場合）

特定のワークスペースだけが開けない（別のワークスペースは問題なく起動する）場合、パースペクティブやビューの設定ファイルが破損している可能性があります。

削除するファイルは以下です。

[ワークスペース]/.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi

このファイルはEclipseのウィンドウ配置（パースペクティブ・ビューの開き方）を記録しているものです。
削除するとウィンドウ配置の設定はリセットされますが、プロジェクト自体のデータには影響しません。

対処法6：eclipse.iniのメモリ設定を見直す（メモリ不足・JVMエラーの場合）

ログに OutOfMemoryError や JVMの起動失敗に関するメッセージがある場合、eclipse.iniのメモリ設定が原因の可能性があります。

eclipse.ini内の以下の設定を確認します。

-Xms256m
-Xmx1024m
  • -Xms：Eclipseが起動時に確保するメモリ量（初期ヒープサイズ）
  • -Xmx：Eclipseが使用できる最大メモリ量（最大ヒープサイズ）

-XmxにPCの物理メモリを超えた値が設定されている場合（例：物理メモリ8GBに対して-Xmx8gなど）、JVMの起動に失敗します。
物理メモリの半分以下を目安に設定してください。

また、古いEclipseの設定ファイルに以下の記述が残っている場合、Java 8以降では無効なオプションとしてエラーになります。

-XX:MaxPermSize=256m
--launcher.XXMaxPermSize

この記述はeclipse.iniから削除してください。

対処法7：.metadataフォルダをリネームして初期化する

上記の個別ファイル削除で改善しない場合、.metadataフォルダ全体をリネームして初期化する方法があります。
プロジェクトのソースファイル自体は.metadata外に保存されているため、この操作でコードが消えることはありません。

手順：

  1. Eclipseを完全に終了する
  2. [ワークスペース]/.metadata フォルダを .metadata_bak などにリネームする
  3. Eclipseを起動する（.metadataが再生成されて起動できるようになります）
  4. 起動できた場合は、既存プロジェクトを「ファイル → インポート → 既存プロジェクトをワークスペースへ」から再登録する
  5. 問題が解決しなかった場合は .metadata_bak を元の名前に戻す

注意：この操作を行うとEclipseの各種設定（フォント・プラグイン設定・ウィンドウ配置など）がリセットされます。

対処法8：新しいワークスペースに切り替える

.metadataの初期化でも改善しない場合、新しいワークスペースを作成してプロジェクトをインポートする方法が最も確実です。

手順（Eclipseが起動できる場合）：

  1. 「ファイル」→「ワークスペースの切り替え」→「その他」をクリックする
  2. ワークスペースランチャー画面で、空の新しいフォルダを指定する
  3. 既存プロジェクトを「ファイル → インポート → 既存プロジェクトをワークスペースへ」で取り込む

Eclipseが起動できない場合：

Eclipseの起動時に表示されるワークスペース選択ダイアログで、別のフォルダを指定して起動できます。
ダイアログが表示されない設定になっている場合は、-dataオプションで別のワークスペースパスを指定して起動できます。

eclipse.exe -data C:\new-workspace

対処法の優先順位まとめ

手順操作データへの影響
1ログ確認（.metadata/.log）なし
2-cleanオプション起動なし
3.lockファイル削除なし
4.snapファイル削除なし
5workbench.xmi削除ウィンドウ配置がリセット
6eclipse.iniのメモリ設定修正なし
7.metadataをリネーム設定がリセット（コードは無事）
8新ワークスペースに切り替え設定がリセット（コードは無事）

まとめ

EclipseのワークスペースまわりのトラブルはOSの強制シャットダウンや予期しないクラッシュが主な引き金です。
まず -clean 起動を試し、次にエラーログを確認しながら .lock → .snap → workbench.xmi の順でファイルを削除していくのが安全なアプローチです。
プロジェクトのソースコードは .metadata の外に保管されているため、.metadata 関連ファイルを削除してもコード自体が消えることはありません。
いずれの対処法も試す前に、ワークスペースフォルダのバックアップを取ることを強くおすすめします。

参考情報源：

Youtube

神話・歴史・伝承の解説チャンネル

スポンサーリンク

コメント

タイトルとURLをコピーしました