C++ 與 Java 混合專案部署至 Tomcat 實戰指南

問題背景

既有獨立版程式採 C++ 與 Java 混合開發，現需增加 Web 介面，尋求在 Tomcat 上部署混合程式的方案。

核心方案：JNI 橋接 + 標準 Web 應用打包

本質上仍是 Java 程式：C++ 負責底層介面（透過 JNI 暴露給 Java），Java 呼叫 C++ 原生庫，上層包裝為標準 Java Web 應用（WAR）。

部署步驟

1. 將 C++ 編譯為平台專屬動態庫（Windows .dll / Linux .so）。
2. Java 端透過 System.loadLibrary() 或 System.load() 載入原生庫。
3. 確保原生庫放在 java.library.path 指定目錄（如 Tomcat 的 bin 目錄或自訂路徑並啟動時加入 -Djava.library.path=...）。
4. 專案打包為標準 WAR 檔，放入 Tomcat webapps 目錄自動展開部署。
5. 驗證：啟動 Tomcat，存取 Web 介面測試 C++ 功能是否正常被 Java 呼叫。

關鍵注意事項

• 原生庫位元數（32/64-bit）必須與 JVM 位元數一致。
• 生產環境建議將原生庫置於系統庫路徑或專用目錄，避免相對路徑問題。
• C++ 記憶體管理需自行負責，避免洩漏導致 JVM 崩潰。
• 異常處理：C++ 異常需轉換為 Java 異常拋出，防止 JVM 非預期終止。

結語

「C++ 做介面，Java 呼叫，終歸是 Java 程式」—— 以標準 WAR 部署至 Tomcat，配合 JNI 載入原生庫，是混合專案 Web 化的最佳路徑。