BIRT 報表引擎部署到 Tomcat 完整步驟與簽名衝突解決

環境版本

• Tomcat 7.0
• BIRT Runtime 4.6.0 (20160607)
• JRE 1.8

部署步驟

1. 安裝 Tomcat，驗證 https://localhost:8080 出現貓頁面。
2. 解壓 BIRT Runtime，將 birt.war 複製到 webapps/。
3. 啟動 Tomcat (bin/startup.sh|bat)。
4. 報錯：日誌顯示簽名驗證失敗 (ECLIPSE_.SF、ECLIPSE_.RSA)。

根因與修復

BIRT WAR 內的 org.eclipse.birt.runtime_X.X.X.jar 簽名與 Tomcat 安全管理衝突。

1. 進入 webapps/birt/WEB-INF/lib/。
2. 用壓縮工具打開 org.eclipse.birt.runtime_4.6.0.v20160607.jar。
3. 進入 META-INF/，刪除 ECLIPSE_.SF 和 ECLIPSE_.RSA 兩個簽名文件。
4. 重啟 Tomcat，BIRT 首頁正常訪問。

驗證

訪問 https://localhost:8080/birt，出現 BIRT Viewer 頁面即部署成功。可上傳 .rptdesign 測試報表渲染。

避坑提示

• Tomcat 8/9 同理，若啟用 SecurityManager 需額外配置權限。
• BIRT 4.7+ 可能已修復簽名問題，優先嘗試新版。
• 生產環境建議外掛數據源 JNDI，而非內嵌 JDBC 配置。

記錄一次踩坑經驗，希望能幫到後人快速跑通 BIRT 環境。