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

Linux 下 JDK 與 Tomcat 環境變量配置實戰筆記：避坑指南與驗證步驟

編輯：Java 相關知識

前置準備

下載 JDK .bin (自解壓安裝包) 與 Tomcat .tar.gz (解壓即用)。
統一放入 /usr/local/src/ 目錄便於管理。

安裝 JDK

cd /usr/local/src
chmod +x jdk-6u10-linux-x64.bin   # 版本號以實際文件為準
./jdk-6u10-linux-x64.bin          # 接受許可證輸入 yes，自動解壓到 jdk1.6.0_10/

安裝 Tomcat

cd /usr/local/src
tar -zxvf apache-tomcat-6.0.18.tar.gz   # 解壓到 apache-tomcat-6.0.18/

環境變量配置 — 關鍵差異：Windows 用「;」Linux 用「:」

編輯 /etc/profile (全局生效) 或 ~/.bash_profile (當前用戶)，在文件末尾追加：

# JDK
export JAVA_HOME=/usr/local/src/jdk1.6.0_10
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

# Tomcat
export CATALINA_HOME=/usr/local/src/apache-tomcat-6.0.18
export CATALINA_BASE=/usr/local/src/apache-tomcat-6.0.18

避坑提醒：Windows 下 PATH=...;...;... 用分號；Linux/Unix 下 PATH=...:...:... 用冒號。初學者常因沿用分號導致命令不生效。

立即生效並驗證

source /etc/profile        # 或重新登錄

# 1. 驗證 JDK
java -version
# 預期輸出:
# java version "1.6.0_10"
# Java(TM) SE Runtime Environment (build 1.6.0_10-b33)
# Java HotSpot(TM) 64-Bit Server VM (build 11.0-b15, mixed mode)

# 2. 啟動 Tomcat
$CATALINA_HOME/bin/startup.sh
# 預期輸出:
# Using CATALINA_BASE:   /usr/local/src/apache-tomcat-6.0.18
# Using CATALINA_HOME:   /usr/local/src/apache-tomcat-6.0.18
# Using CATALINA_TMPDIR: /usr/local/src/apache-tomcat-6.0.18/temp
# Using JRE_HOME:        /usr/local/src/jdk1.6.0_10

# 3. 瀏覽器訪問
# https://localhost:8080/  → 看到 Tomcat 貓咪歡迎頁即成功

Tomcat 6 管理控制台啟用 (缺失 manager 模塊補救)

Tomcat 6 預設不包含管理 Webapp，需手動添加用戶角色：

vim $CATALINA_HOME/conf/tomcat-users.xml
# 在  標籤內添加:

重啟 Tomcat：$CATALINA_HOME/bin/shutdown.sh && $CATALINA_HOME/bin/startup.sh

瀏覽器訪問 https://localhost:8080/manager/html，輸入 tomcat/tomcat 進入管理後台。

常見故障排查清單

現象	可能原因	處置
`java: command not found`	PATH 未生效/寫錯分隔符	`echo $PATH` 檢查冒號、source 生效
Tomcat 啟動報 `JAVA_HOME not set`	JAVA_HOME 為空或指向錯誤目錄	確認 `$JAVA_HOME/bin/java` 可執行
端口 8080 被佔用	其他進程/殘留 Tomcat	`netstat -ntlp \| grep 8080` kill -9 PID
中文亂碼	JVM/OS 編碼不一致	在 `catalina.sh` 加 `JAVA_OPTS="-Dfile.encoding=UTF-8"`
權限不足	非 root 安裝目錄不可寫	`chown -R $USER:$USER /usr/local/src/...`

現代化建議 (2024+)

JDK：優先選用 LTS 版本 (11, 17, 21) 的 .tar.gz 解壓版，而非 .bin/.rpm/.deb，便於多版本共存 (update-alternatives / sdkman)。
Tomcat：生產環境建議 Tomcat 9/10.1 (Servlet 4.0/5.0/6.0)，支援 HTTP/2、Virtual Threads (Tomcat 10.1+)。
進程管理：改用 systemd 服務單元 (/etc/systemd/system/tomcat.service) 實現開機自啟、崩潰自愈、日誌集中 (journald)。
容器化：docker run -d -p 8080:8080 tomcat:10.1-jdk21 一行解決環境一致性。

結語

Linux 下 JDK+Tomcat 配置的核心只有三步：解壓安裝 → 環境變量 (冒號分隔) → 驗證啟動。記住「冒號不分號」、善用 source 立即生效、養成 $CATALINA_HOME/bin 管理啟停習慣，即可避開 90% 新手坑。進階路上，擁抱 LTS JDK、systemd、Docker，讓環境配置成為「基礎設施即代碼」的一部分。