萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 開發環境建置完整指南:JDK、Tomcat、CLASSPATH 設定

一、Java 開發工具套件 (JDK) 安裝與配置

1. 下載 JDK

  • 官方下載:Oracle Java SE Downloads 或 OpenJDK (Adoptium, Temurin, Amazon Corretto)
  • 選擇 LTS 版本:Java 17 / 21 (長期支援)

2. 安裝與環境變數設定

Windows

  1. 執行安裝程式,預設路徑 `C:\Program Files\Java\jdk-21`
  2. 設定系統環境變數 (Win+Pause → 進階系統設定 → 環境變數):
JAVA_HOME = C:\Program Files\Java\jdk-21
Path 新增: %JAVA_HOME%\bin
  1. 驗證:`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

現代標準:建構工具管理

provided / `compileOnly`:編譯期需要,打包 WAR 時不包含 (由容器提供)。

四、整合開發環境 (IDE) 推薦

工具依賴宣告範例Scope
Maven`jakarta.servletjakarta.servlet-api6.0.0provided`provided
Gradle`providedCompile 'jakarta.servlet:jakarta.servlet-api:6.0.0'`compileOnly

五、建立第一個 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 熱部署

六、常見問題排查

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 專案
問題原因與解決
啟動失敗: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 Foundwebapps 部署結構錯誤 (需含 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