Tomcat 常見問題排查與核心命令速查：JDK 位數驗證、啟動腳本、部署驗證、位數不匹配錯誤

Tomcat 常見問題排查與核心命令速查：JDK 位數驗證、啟動腳本、部署驗證、位數不匹配錯誤

Tomcat 是最流輕量級 Servlet 容器，本文整理日常運維必備命令與典型故障排查。

1. 驗證 JDK 位數

# 進入 JDK bin 目錄
java -version
# 輸出包含 "64-Bit Server VM" → 64 位
# 無此標識 → 32 位 (Client VM)

2. Tomcat 核心命令 (bin 目錄下)

3. IDEA/Eclipse 部署驗證

1. 配置 Server Runtime Environment 指向 Tomcat 安裝目錄。
2. 將 Web 模塊添加到 Server。
3. 啟動 Server (Debug 模式便於斷點)。
4. 瀏覽器訪問 https://localhost:8080/<context-path>/xxx.jsp，看到頁面即成功。

4. 經典錯誤：JDK/Tomcat 位數與 OS 不匹配

現象：啟動報錯 %1 不是有效的 Win32 應用程序 或 Could not create the Java virtual machine。

原因：64 位 OS 安裝了 32 位 JDK + 32 位 Tomcat，或反之。
解決：統一 JDK、Tomcat、OS 位數 (推薦全 64 位)。

5. 常用目錄結構

apache-tomcat-x.x.xx/
├── bin/          # 啟動/關閉/工具腳本
├── conf/         # server.xml, web.xml, tomcat-users.xml, logging.properties
├── lib/          # 容器公共 JAR (servlet-api, jsp-api, jdbc drivers...)
├── logs/         # catalina.out, localhost.yyyy-mm-dd.log, manager.xxx.log
├── webapps/      # 自動部署目錄 (ROOT.war, docs, examples, manager, host-manager)
├── work/         # JSP 編譯產生的 Servlet 源碼/.class
└── temp/         # 臨時文件

6. 關鍵配置修改

• 端口：conf/server.xml → <Connector port="8080" .../>
• JVM 參數：bin/setenv.sh/bat → CATALINA_OPTS="-Xms512m -Xmx2g -XX:MetaspaceSize=256m"
• 訪問日誌：server.xml → <Valve className="org.apache.catalina.valves.AccessLogValve" .../>