您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

JSP 開發環境零基礎搭建：JDK + Tomcat + 環境變數全攻略

編輯：Java 相關知識

軟體版本 (教學建議版本)

JDK: Java SE 8 / 11 / 17 LTS** (官網下載)
Tomcat: Tomcat 9.0.x / 10.1.x** (官網下載)
IDE: IntelliJ IDEA Community / Eclipse IDE for Enterprise Java Developers**

本文更新原教程 (JDK 1.4.2 + Tomcat 4.1) 為現代 LTS 版本，舊版本已停止維護、存在安全漏洞，請勿用於生產。

步驟 1：安裝 JDK 並配置環境變數

運行安裝程式，預設路徑如 C:\Program Files\Java\jdk-17。
設置系統環境變數 (Win+Pause → 高級系統設置 → 環境變數)：
- 新建 JAVA_HOME = C:\Program Files\Java\jdk-17 (安裝根目錄)
- 編輯 Path，新增 %JAVA_HOME%\bin
- 可選 CLASSPATH = .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar (現代 Maven/Gradle 專案通常不需手動設置)
驗證：CMD 執行 java -version、javac -version、echo %JAVA_HOME% 均正確輸出。

步驟 2：安裝 Tomcat 並配置環境變數

解壓 apache-tomcat-9.0.x.zip 至目標目錄 (如 D:\apache-tomcat-9.0.80)，**建議解壓而非 EXE 安裝**，便於多版本共存與權限控制。
設置系統環境變數：
- 新建 CATALINA_HOME = D:\apache-tomcat-9.0.80
- 新建 CATALINA_BASE = D:\apache-tomcat-9.0.80 (單實例通常相同)
- 編輯 Path，新增 %CATALINA_HOME%\bin
驗證：CMD 執行 startup.bat，瀏覽器訪問 https://localhost:8080 見「If you're seeing this page...」貓頁面。
關閉：執行 shutdown.bat。

步驟 3：IDE 整合 Tomcat (以 IntelliJ IDEA 為例)

File → Settings → Build, Execution, Deployment → Application Servers → + → Tomcat Server → 指定 CATALINA_HOME 目錄。
建立 Java Web 專案：New Project → Jakarta EE → Web Application → 選擇剛配置的 Tomcat。
專案結構自動生成 webapp/WEB-INF/web.xml。
編寫 index.jsp，點擊工具欄綠色三角形 (Run) 即可熱部署啟動。

步驟 4：資料庫連線驅動配置 (MySQL 為例)

下載 mysql-connector-j-8.x.x.jar (Maven 專案直接加依賴)。
非 Maven 專案：將 jar 放入 $CATALINA_HOME/lib/ (全域共享) 或專案 WEB-INF/lib/ (隔離)。

配置 JNDI 資料源 (context.xml)：

<Resource name="jdbc/mydb"
    auth="Container"
    type="javax.sql.DataSource"
    driverClassName="com.mysql.cj.jdbc.Driver"
    url="jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC"
    username="root"
    password="123456"
    maxTotal="20"
    maxIdle="10"
    maxWaitMillis="-1"/>

JSP/Servlet 中查找：DataSource ds = (DataSource) new InitialContext().lookup("java:comp/env/jdbc/mydb");

常見問題快速排查

現象	原因	解決
JAVA_HOME 未設置 / 指向 JRE	安裝路徑錯誤	指向 JDK 根目錄 (含 bin、lib、include)
Tomcat 閃退 / 雙擊 startup.bat 即關閉	JAVA_HOME 錯誤、端口佔用、JDK/JRE 版本不匹配	CMD 運行 startup.bat 看錯誤輸出；檢查 8080 端口
JSP 編譯錯誤：Unsupported class file major version	Tomcat 版本不支援 JDK 版本	Tomcat 9 支援 JDK 8-17，Tomcat 10.1+ 支援 JDK 11-21，請匹配版本
中文亂碼	編碼不一致	JSP 頁面 `pageEncoding="UTF-8"`、Tomcat `server.xml` Connector 加 `URIEncoding="UTF-8"`、DB 連線 URL 加 `characterEncoding=utf8`

現代化建議

使用 SDKMAN! (Linux/macOS) 或 Scoop/Chocolatey (Windows) 管理 JDK、Maven、Gradle 版本。
採用 Spring Boot 內嵌 Tomcat/Jetty/Undertow，**完全省去外部 Tomcat 安裝配置**。
容器化部署：Dockerfile 基於 eclipse-temurin:17-jre + tomcat:9-jre17 或 Spring Boot 瘦鏡像。