一、Java 開發工具套件 (JDK) 安裝與配置
1. 下載 JDK
- 官方下載:Oracle Java SE Downloads 或 OpenJDK (Adoptium, Temurin, Amazon Corretto)
- 選擇 LTS 版本:Java 17 / 21 (長期支援)
2. 安裝與環境變數設定
Windows
- 執行安裝程式,預設路徑 `C:\Program Files\Java\jdk-21`
- 設定系統環境變數 (Win+Pause → 進階系統設定 → 環境變數):
JAVA_HOME = C:\Program Files\Java\jdk-21
Path 新增: %JAVA_HOME%\bin
- 驗證:`cmd` → `java -version`、`javac -version`、`echo %JAVA_HOME%`
Linux / macOS
# 解壓至 /usr/local/java/jdk-21
# 設定 ~/.bashrc 或 ~/.zshrc
export JAVA_HOME=/usr/local/java/jdk-21
export PATH=$JAVA_HOME/bin:$PATH
# 立即生效
source ~/.bashrc
# 驗證
java -version
二、Web 伺服器:Apache Tomcat 安裝配置
1. 下載
- 官網:tomcat.apache.org → Download → Tomcat 10.1.x (Servlet 6.0 / JSP 3.1 / Java 11+) 或 Tomcat 9.0.x (Servlet 4.0 / JSP 2.3 / Java 8+)
- 下載 `zip` (Windows) 或 `tar.gz` (Linux/macOS) 二進位發布版
2. 安裝與環境變數
# Windows: 解壓至 D:\apache-tomcat-10.1
# 環境變數
CATALINA_HOME = D:\apache-tomcat-10.1
Path 新增: %CATALINA_HOME%\bin
# Linux/macOS: 解壓至 /opt/tomcat
export CATALINA_HOME=/opt/tomcat
export PATH=$CATALINA_HOME/bin:$PATH
3. 啟動與驗證
# Windows
startup.bat
# 或
catalina.bat run
# Linux/macOS
startup.sh
# 或
catalina.sh run
- 預設埠號:8080
- 瀏覽器訪問:
https://localhost:8080/
- 看到 Tomcat 貓咪歡迎頁 → 成功
4. 關閉
shutdown.bat / shutdown.sh
# 或 Ctrl+C (若用 catalina run 前景模式)
5. 關鍵目錄結構
| 目錄 | 用途 |
| bin/ | 啟動/關閉腳本、Tomcat 原生庫 |
| conf/ | server.xml (核心設定)、web.xml (全域部署描述符)、tomcat-users.xml |
| webapps/ | Web 應用部署目錄 (WAR 或展開目錄) |
| logs/ | catalina.out、localhost_access_log、manager 等日誌 |
| lib/ | 共享庫 (JDBC 驅動、共用 JAR) |
| work/ | JSP 編譯產生的 Servlet 原始碼/類別 |
| temp/ | 臨時檔案 |
三、CLASSPATH 環境變數設定
現代建議:不要設定全域 CLASSPATH。使用建構工具管理依賴。
傳統手動設定 (僅教學/簡單專案)
# Windows
set CLASSPATH=.;%CATALINA_HOME%\lib\servlet-api.jar;%CATALINA_HOME%\lib\jsp-api.jar;%CLASSPATH%
# Linux/macOS
export CLASSPATH=.:$CATALINA_HOME/lib/servlet-api.jar:$CATALINA_HOME/lib/jsp-api.jar:$CLASSPATH
- `.` 代表當前目錄
- Servlet/JSP API 必須在編譯期可用
- 執行期由容器提供,勿打包進 WAR
現代標準:建構工具管理
| 工具 | 依賴宣告範例 | Scope |
| Maven | `jakarta.servletjakarta.servlet-api6.0.0provided` | provided |
| Gradle | `providedCompile 'jakarta.servlet:jakarta.servlet-api:6.0.0'` | compileOnly |
provided / `compileOnly`:編譯期需要,打包 WAR 時不包含 (由容器提供)。
四、整合開發環境 (IDE) 推薦
| IDE | 特色 | 適用場景 |
| IntelliJ IDEA Ultimate | 智慧提示、重構、Spring/Jakarta EE 深度整合、資料庫工具 | 專業企業開發首選 |
| Eclipse IDE for Enterprise Java | 免費開源、插件生態豐富、WildFly/GlassFish 整合 | 傳統企業、成本敏感 |
| VS Code + Extension Pack for Java | 輕量、跨平台、擴充彈性 | 微服務、前後端同專案、學習 |
| NetBeans / Apache NetBeans | 官方支援 Jakarta EE、視覺化 Web 開發 | 教學、原生 EE 專案 |
五、建立第一個 JSP 專案驗證環境
Maven 快速建立
mvn archetype:generate \
-DarchetypeArtifactId=maven-archetype-webapp \
-DgroupId=com.example \
-DartifactId=my-jsp-app \
-Dversion=1.0-SNAPSHOT
目錄結構
my-jsp-app/
├── pom.xml
└── src/
└── main/
├── webapp/
│ ├── index.jsp
│ └── WEB-INF/
│ └── web.xml
└── java/
└── com/example/...
index.jsp 驗證
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<!DOCTYPE html>
<html>
<head><title>JSP Env Test</title></head>
<body>
<h1>JSP 環境建置成功!</h1>
<p>Server Time: <%= new java.util.Date() %></p>
<p>Java Version: <%= System.getProperty("java.version") %></p>
<p>Servlet Version: <%= application.getMajorVersion() %>.<%= application.getMinorVersion() %></p>
</body>
</html>
建置部署
mvn clean package
# 產生 target/my-jsp-app.war
# 複製至 $CATALINA_HOME/webapps/ 或 IDE 熱部署
六、常見問題排查
| 問題 | 原因與解決 |
| 啟動失敗:Port 8080 occupied | 修改 `conf/server.xml` `` 或關閉佔用程序 |
| JSP 編譯錯誤:cannot find symbol | 缺少 servlet-api/jsp-api 依賴,或版本不匹配 (Tomcat 10+ 使用 jakarta.* 套件) |
| 中文亂碼 | `server.xml` Connector 加 `URIEncoding="UTF-8"`,JSP `pageEncoding="UTF-8"`,DB 連線 UTF-8 |
| 404 Not Found | webapps 部署結構錯誤 (需含 WEB-INF/web.xml),Context Path 設定 |
| Hot Deploy 不生效 | IDE 設定啟用熱部署、JRebel、或 `spring-boot-devtools` (Spring Boot 專案) |
七、生產環境部署檢查清單
- ✅ JDK 版本與 Tomcat 版本相容性對照表
- ✅ JVM 參數調優:`-Xms2g -Xmx4g -XX:+UseG1GC -XX:MaxMetaspaceSize=512m`
- ✅ `conf/server.xml`:關閉預設管理應用、設定 `maxThreads`、`connectionTimeout`、啟用壓縮 `compression="on"`
- ✅ 安全:`tomcat-users.xml` 強密碼、限制 Manager/Host Manager 存取 IP、啟用 HTTPS (SSL/TLS 憑證)
- ✅ 日誌輪轉:`conf/logging.properties` 設定 `maxDays`、`maxFileSize`
- ✅ 監控:JMX Exporter + Prometheus + Grafana、或商業 APM (DataDog, New Relic)
- ✅ 備份與災難恢復演練
copyright ©
萬盛學電腦網 all rights reserved