この記事の要点

Eclipse でサーバー（Tomcat）とプロジェクトを紐付ける方法 サーバービューで対象サーバを右クリック → 「追加および除去」 左ペインのプロジェクトを選択して「追加 (Add)」 → 「完了 (Finish)」 紐付け後はサーバ起動時にプロジェクトも自動デプロイされる プロジェクトが追加対象に出ない場合は動的 Web ファセット未設定が原因

前提

• Eclipse に Tomcat ランタイムが登録済み（ウィンドウ → 設定 → サーバー → ランタイム環境）
• サーバービューに Tomcat サーバが追加済み（サーバービュー右クリック → 新規 → サーバー）
• 対象プロジェクトが動的 Web プロジェクトであること（Java プロジェクトでは紐づけ不可）

紐づけ手順

1. Eclipse 下部の サーバービュー (Servers) を開く（表示されていない場合: ウィンドウ → ビューの表示 → サーバー）
2. 紐付けたいサーバを右クリック → 「追加および除去 (Add and Remove...)」を選択
3. 表示されるウィンドウで:
   • 左ペイン「Available」: サーバに追加可能なプロジェクト一覧
   • 右ペイン「Configured」: 既に紐付いているプロジェクト
4. 追加したいプロジェクトを左ペインから選択 → 「追加 (Add >)」ボタン
5. 「完了 (Finish)」を押す
6. サーバビューに、紐付けたプロジェクトが子要素として表示されれば成功

紐づけ後の確認

• サーバを起動（▶ ボタンまたは右クリック → Start）
• コンソールビューに INFO: Server startup in xxx ms 等が出れば起動成功
• ブラウザで http://localhost:8080/プロジェクト名/ にアクセス
• Eclipse の Web ブラウザ内蔵表示: サーバービューでサーバを右クリック → Debug on Server でも可能

追加対象に出てこない場合

「Available」ペインに対象プロジェクトが表示されないのは以下が原因:

原因	対処
動的 Web ファセットが未設定	プロジェクト右クリック → プロパティ → プロジェクト・ファセット → 動的 Web モジュールにチェック
ターゲット・ランタイムが Tomcat になっていない	プロパティ → ターゲット・ランタイムで Tomcat にチェック
プロジェクトが「閉じている」	右クリック → プロジェクトを開く
Servlet バージョンと Tomcat バージョンの不一致	例: Servlet 5.0 (Jakarta) は Tomcat 10 以上が必要
すでに別のサーバーに紐付け済み	そちらから除去するか、同時運用なら問題なし

除去（紐づけ解除）の手順

1. サーバービューで対象サーバを右クリック → 「追加および除去」
2. 右ペインから外したいプロジェクトを選択 → 「< 削除 (Remove)」
3. 「完了」
4. もしくはサーバビューに表示されるプロジェクト直接右クリック → 「削除」でも可

サーバーの「Publish」（デプロイ）について

紐付け後、Eclipse はプロジェクトの変更を Tomcat に Publish（デプロイ）します:

• 自動 Publish: 既定でファイル変更時に自動反映
• 手動 Publish: サーバ右クリック → Publish (Ctrl + Shift + P)
• Publish 動作の設定: サーバをダブルクリック → Publishing セクション
• 「Never publish automatically」: 開発中に頻繁なリロードを抑制したい場合
• 「Automatically publish after a build event」: ビルド完了ごとに反映

「Use Tomcat installation」 vs 「Use workspace metadata」

サーバ設定をダブルクリックして開く「サーバーの場所」項目には 2 つの選択肢:

オプション	動作
Use workspace metadata	Eclipse のワークスペース内に展開（外部 Tomcat の webapps/ に影響しない）
Use Tomcat installation (推奨)	実 Tomcat の webapps/ にデプロイ。コマンドラインからも同じ Tomcat を起動可能

関連

• サーバービューが表示されない: ウィンドウ → ビューの表示 → その他 → Server → サーバー
• Tomcat が起動しない: ポート 8080 が他プロセスで使用中の可能性。netstat -ano | findstr 8080 で確認
• 404 エラー: コンテキストパスを確認。プロジェクト右クリック → プロパティ → Web Project Settings の Context root
• 変更が反映されない: クリーン → ビルド → サーバ右クリック → 「Clean...」でサーバ側もクリーン

複数プロジェクトを 1 サーバに紐付ける

1 つの Tomcat に複数プロジェクトを同居させられます。それぞれが別コンテキストで動作:

• プロジェクト A: http://localhost:8080/projectA/
• プロジェクト B: http://localhost:8080/projectB/
• サーバービューで Tomcat を展開すると、紐付け中の全プロジェクトが一覧表示される
• 個別プロジェクトの再起動: プロジェクトを右クリック → Restart on Server

サーバビューが空 / サーバが追加できない場合

問題	対処
サーバビューが見つからない	ウィンドウ → ビューの表示 → その他 → Server → サーバー
「新規 → サーバー」に Apache が出てこない	Eclipse IDE for Enterprise Java Developers が必要（Eclipse SE では不足）
サーバ追加ウィザードでランタイムが空	「追加 (Add...)」ボタンから Tomcat インストール先を指定
「Cannot create a server using the selected type」	workspace の .metadata が破損 → 別ワークスペースで再試行

サーバの起動方式（4 種類）

モード	動作	用途
Start	通常起動	動作確認・実装中
Debug	デバッグ用ポートを開いて起動	ブレークポイント・ステップ実行
Profile	プロファイラ接続用ポート	パフォーマンス計測
Stop	停止	変更後の再起動時

本番運用との違い

Eclipse 経由の Tomcat 起動は開発専用。本番では:

• WAR エクスポートして本番 Tomcat の webapps/ に配置
• または CI/CD で Maven / Gradle ビルド → ZIP / Docker イメージ化
• 外部設定（DB / メール設定）は環境変数や application-prod.properties で分離
• ログは Eclipse コンソールではなく /var/log/tomcat/ に出力

関連

• サーバの設定画面: サーバビューでサーバをダブルクリック → 各種設定（ポート / Publish 動作 / Timeout）
• HTTP ポート変更: 「Ports」セクションで「HTTP/1.1」のポート番号を 8080 から別の番号に
• Tomcat マネージャ: 別途設定すれば http://localhost:8080/manager/html から GUI でアプリ管理可能
• maven-tomcat7-plugin: Eclipse なしで Maven コマンド経由で起動する方法