準備工作
- 已安裝 JDK（配置
JAVA_HOME）
- 已下載 Eclipse IDE for Enterprise Java Developers
- 已下載 Apache Tomcat（解壓即用）
配置步驟
1. 配置 Server Runtime Environment
- 打開 Eclipse，選單 Window → Preferences
- 左側樹選 Server → Runtime Environments
- 點擊 Add...，選擇對應 Tomcat 版本（如 Tomcat 9.0）
- 勾選 Create a new local server，點 Next
- Tomcat installation directory 選擇 Tomcat 解壓根目錄
- JRE 選擇已配置的 JDK，完成
2. 在 Servers 視圖創建 Server 實例
- 打開 Window → Show View → Servers
- 右鍵空白處 New → Server
2. 選擇剛添加的 Tomcat v9.0 Server，Next
3. 可調整部署路徑（默認 wtpwebapps），Finish
3. 創建 Dynamic Web Project
- File → New → Dynamic Web Project
- Project name:
DemoWeb
- Target runtime: 選擇剛配置的 Tomcat
- Configuration: 默認，Finish
4. 編寫測試 Servlet
@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
resp.setContentType("text/html;charset=UTF-8");
resp.getWriter().write("<h1>Hello, Tomcat in Eclipse!</h1>");
}
}
5. 部署與啟動
- 右鍵專案 Run As → Run on Server
- 選擇剛創建的 Tomcat，Finish
- Eclipse 會自動發布專案到 Tomcat 的
webapps，並啟動瀏覽器訪問 https://localhost:8080/DemoWeb/hello
常見問題排查
| 問題 | 可能原因 | 解決方案 |
|---|
| 端口 8080 被佔用 | 其他 Tomcat/服務運行中 | 修改 server.xml <Connector port="8081"/> 或停止佔用進程 |
| 404 Not Found | 專案未發布 / Context Path 錯誤 | Servers 視圖右鍵 Tomcat → Clean → Publish；檢查 web.xml 或 @WebServlet 路徑 |
| ClassNotFound: Servlet API | 專案未引用 Server Runtime Library | 專案 Properties → Java Build Path → Libraries → Add Library → Server Runtime |
進階技巧
- 熱部署：Server 編輯器勾選 Automatically publish when resources change，修改代碼保存後自動重載（無需重啟）。
- 遠程調試：Tomcat
bin/catalina.sh 添加 JPDA_ADDRESS=8000，Eclipse Debug Configurations → Remote Java Application 連接 8000 端口。
- 多模組管理：使用 Maven 管理依賴，Eclipse 導入為 Maven Projects，配合
mvn eclipse:eclipse 或 m2e 插件。
