環境準備
- OS:Windows 10 64-bit
- JDK:已配置
JAVA_HOME 環境變數
- Tomcat:apache-tomcat-7.0.57-windows-x64(解壓即用綠色版)
Tomcat 獨立運行驗證
- 進入
bin 目錄,雙擊 startup.bat(Linux 執行 ./startup.sh)。
- 瀏覽器輸入
https://localhost:8080/,出現 Tomcat 貓首頁表示成功。
- 關閉執行
shutdown.bat / ./shutdown.sh。
Eclipse 安裝 Tomcat 外掛
- 下載
com.sysdeo.eclipse.tomcat_版本.zip,解壓至 eclipse/plugins 目錄,或建立 .link 檔指向外掛目錄。
- 重啟 Eclipse,工具列出現 Tomcat 圖示(啟動/停止/重啟)。
- 偏好設定
Tomcat → 設定 Tomcat Home 指向解壓目錄,JRE 選擇 JDK 目錄。
建立標準 Web 專案目錄結構
WebProject/
├── webapps/ <-- Web 內容根目錄
│ ├── index.html <-- 歡迎頁
│ └── WEB-INF/
│ ├── web.xml <-- 部署描述符
│ ├── classes/ <-- 編譯後 .class 檔案
│ └── lib/ <-- 依賴 jar (servlet-api.jar 等)
關鍵配置檔案
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://xmlns.jcp.org/xml/ns/javaee"
version="3.1">
<servlet>
<servlet-name>HelloServlet</servlet-name>
<servlet-class>com.example.HelloServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>HelloServlet</servlet-name>
<url-pattern>/hello</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
</web-app>
server.xml 配置 Context 路徑(可選)
<Host name="localhost" appBase="webapps" ...>
<Context path="/myapp" docBase="WebProject/webapps" reloadable="true"/>
</Host>
Eclipse 部署步驟
- 右鍵專案 →
Properties → Java Build Path → Libraries → Add External JARs 選擇 servlet-api.jar(位於 Tomcat lib 目錄)。
- 將編譯輸出目錄設為
webapps/WEB-INF/classes。
- 在 Eclipse Tomcat 面板點擊「啟動」,Console 無紅字即成功。
- 瀏覽器訪問
https://localhost:8080/myapp/hello 驗證 Servlet。
常見問題排查
| 現象 | 原因 | 解決 |
| 404 Not Found | Context path 或 url-pattern 錯誤 | 檢查 server.xml Context path、web.xml servlet-mapping |
| ClassNotFoundException: Servlet | servlet-api.jar 未加入 Build Path 或版本衝突 | 確保只引入 Tomcat 提供的 servlet-api.jar,不要放入 WEB-INF/lib |
| 端口 8080 被佔用 | 其他程式佔用 | 修改 server.xml <Connector port="8081"/> 或殺掉佔用進程 |
| 中文亂碼 | Tomcat 預設 ISO-8859-1 | server.xml Connector 加 URIEncoding="UTF-8";Servlet 設定 request/response encoding |
總結
掌握「獨立驗證 → 外掛配置 → 目錄規範 → 描述符配置 → 建置路徑 → 啟動驗證」六步驟,即可在 Eclipse 中高效開發、除錯 Tomcat Web 應用。
- 上一篇文章: Java 內部類完整指南:定義規則、訪問權限、靜態內部類與實例化語法
- 下一篇文章: Java Web MVC 開發模式入門心得:分層架構、職責邊界與工廠模式實踐
Copyright ©
程式碼之家 All Rights Reserved