Tomcat 跨虛擬機平台部署差異：OpenStack vs VMWare 環境排查指南

故障現象

同一 Tomcat + 應用，在 OpenStack 虛擬機 (機器1-3) 正常，在 VMWare 虛擬機 (機器4) 啟動成功但功能服務加載失敗。

核心差異維度

排查清單（按可能性排序）

1. 網絡與端口（最常見）

• 安全組/防火牆：VMWare 環境安全組規則是否放行應用端口（如 8080、服務註冊端口、DB 端口）。
• MTU 不匹配：OpenStack 通常 MTU=1450 (VXLAN)，VMWare 默認 1500，導致大包丟失 → 服務註冊/心跳失敗。
• 主機名解析：/etc/hosts、DNS 配置是否一致，服務間調用是否依賴主機名。

2. 文件路徑與權限

• 相對路徑依賴：啟動腳本中 ./logs、../conf 在不同工作目錄下解析不同。
• 掛載點差異：數據盤掛載路徑 /data vs /mnt/data，配置文件硬編碼路徑失效。
• 用戶/組權限：Tomcat 運行用戶 tomcat 在 VMWare 中 UID/GID 不同，導致文件讀寫失敗。

3. 環境變量與配置

• JAVA_HOME、CATALINA_BASE、CATALINA_HOME 是否一致。
• setenv.sh 中 JVM 參數：-Djava.rmi.server.hostname、-Dcom.sun.management.jmxremote 等依賴 IP 的參數。
• 應用配置文件：application.yml 中數據庫、Redis、註冊中心地址是否為內網 IP/域名。

4. 時鐘同步

• VMWare Tools 時間同步 vs 系統 chronyd/ntpd，時間漂移導致 Token 過期、分布式鎖失效、日誌時間混亂。
• 執行 timedatectl status、hwclock 對比。

5. 依賴庫與原生組件

• JNI 本地庫：.so 文件是否隨應用打包，或依賴宿主機安裝（如 libfontconfig、libfreetype）。
• CPU 指令集：OpenStack 虛擬 CPU 模式可能隱藏 AVX/AES-NI，VMWare 傳遞宿主機指令集，JVM 優化路徑不同。

快速定位技巧

1. 查看 Tomcat catalina.out、應用日誌 ERROR 級別堆棧跟蹤。
2. 對比兩環境 netstat -tlnp、ss -tlnp 端口監聽情況。
3. 啟用 JVM 遠程調試 -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005，IDE 連接斷點調試。
4. 最小化驗證：部署只含 HelloWorld Servlet 的 Tomcat，確認基礎運行正常再疊加應用。

「程序完全相同」不代表「運行環境相同」。重點排查網絡 MTU/安全組、文件路徑掛載、時鐘同步、本地庫依賴四大隱性差異，可解決 90% 跨平台部署異常。