過去バージョン

エラー内容

Eclipse でソースを開いたときに以下のようなエラーが出る:

Description: 型 org.apache.tomcat.InstanceManager を解決できません。
必要な .class ファイルから間接的に参照されています

Resource: MyServlet.java
Location: line 1
Type: Java の問題

同種の問題ビューエラー「ビルド・パスが不完全であるため、プロジェクトはビルドされませんでした」もセットで発生することが多いです。

原因

org.apache.tomcat.InstanceManager はTomcat に含まれる API クラスです。Eclipse の動的 Web プロジェクトでは「ターゲット・ランタイム」として Tomcat を関連付けることで、コンパイル時にこのクラスを参照できます。

このエラーは以下の状況で発生:

• Tomcat ランタイムが Eclipse に未登録
• プロジェクトにターゲット・ランタイムが選択されていない
• 登録済み Tomcat のパスが無効 (Tomcat フォルダ移動・削除)
• git clone した他人のプロジェクト（自分の環境に Tomcat 設定がない）
• ワークスペース変更後の設定喪失

対処方法

方法 1: プロジェクトに Tomcat ランタイムを関連付け

1. プロジェクトを右クリック → プロパティ
2. 左メニューから ターゲット・ランタイム を選択
3. 「Apache Tomcat v9.0」などにチェック
4. 「適用して閉じる」

※ 一覧に Tomcat が表示されない場合は方法 2 でランタイム登録から始めます。

方法 2: Eclipse に Tomcat ランタイムを登録

1. ウィンドウ → 設定
2. サーバー → ランタイム環境
3. 追加 → 「Apache Tomcat v9.0」を選択 → 次へ
4. インストール・ディレクトリー: Tomcat フォルダ（例: C:\apache-tomcat-9.0.71）
5. JRE: JDK を選択
6. 完了
7. 方法 1 でプロジェクトに関連付け

方法 3: ビルド・パスから直接 jar を追加（非推奨）

応急処置として、Tomcat の lib/ 内の jar を直接ビルド・パスに追加することもできますが、根本解決ではありません:

1. プロジェクト右クリック → ビルド・パス → ライブラリーの追加
2. 外部 jar → $CATALINA_HOME/lib/tomcat-api.jar 等を追加

確認・解決後の動作

1. プロジェクト → クリーン
2. 問題ビューでエラーが消えていることを確認
3. サーバービューに Tomcat があれば、プロジェクトを追加して起動テスト

関連エラー

git clone 直後の標準セットアップ

1. Eclipse でインポート → 既存プロジェクトで clone フォルダを取り込み
2. 方法 2 で Tomcat ランタイム登録（初回のみ、以後不要）
3. 方法 1 でプロジェクトに関連付け
4. JDK バージョンも揃える（プロパティ → Java コンパイラー）
5. プロジェクト → クリーン

関連記事

• ビルド・パスが不完全...
• tomcatの起動確認方法
• 起動方法