FineReport 版本迭代頻繁，升級能獲得新功能、效能優化與安全性修補。升級分為「設計器升級」與「伺服器升級」兩條軌，操作方式包含重新安裝與 JAR 包替換。本文詳細說明升級前備份、JAR 包對應目錄、版本相容性檢查等關鍵步驟，確保升級平滑無誤。

升級核心原則

• 向下相容：高版本設計器可開啟低版本模板，反之則不行。
• 版本一致性：設計器與伺服器主版本號需一致（如皆為 7.1.x），否則模板部署至伺服器可能渲染異常。
• 備份優先：升級前務必備份原 JAR 包與所有報表模板（.cpt 檔）。

一、設計器升級

方式 A：重新安裝（推薦）

至 FineReport 官網下載最新版安裝包，直接執行安裝。不同版本設計器可共存於同一電腦，互不干擾，方便多專案並行開發。

方式 B：手動替換 JAR 包（適用於增量更新）

向技術支援索取對應版本升級包（如 7.0 → 7.1），包含以下核心 JAR：

JAR 檔名	功能說明	部署目錄（設計器端）
fr-designer-7.1.jar	設計器核心功能	%FR_Home%/lib
fr-server-7.1.jar	伺服器核心功能	%FR_Home%/WebReport/WEB-INF/lib
fr-third-7.1.jar	第三方依賴庫	%FR_Home%/WebReport/WEB-INF/lib
fr-applet-7.1.jar	Applet 列印元件	%FR_Home%/WebReport
commons-codec-1.6.jar	編碼解碼庫（7.1.1 新增）	%FR_Home%/WebReport/WEB-INF/lib

操作步驟：

1. 停止設計器與嵌入式伺服器。
2. 刪除舊版 JAR（如 fr-designer-7.0.jar），**切勿僅重命名**，否則類別載入器仍會讀取舊版。
3. 將新版 JAR 複製至對應目錄。
4. 重新啟動設計器驗證功能。

二、伺服器升級

方式 A：替換 JAR 包（熱更新）

同樣向技術支援索取伺服器端升級包，替換 Web 應用程式目錄下的對應 JAR：

• fr-server-7.1.jar、fr-third-7.1.jar → WebReport/WEB-INF/lib
• fr-applet-7.1.jar → WebReport
• commons-codec-1.6.jar → WebReport/WEB-INF/lib

替換完成後**必須重啟 Servlet 容器（如 Tomcat）生效**。

方式 B：全新安裝設計器後同步 JAR

安裝最新版設計器，將其安裝目錄下的 JAR 包複製至伺服器對應路徑覆蓋。此法確保設計器與伺服器版本完全一致，避免模板在本地正常、部署後異常的情況。

升級後驗證清單

• 設計器啟動無錯誤，開啟既有模板渲染正常。
• 伺服器啟動日誌無 ClassNotFoundException、版本衝突警告。
• 關鍵報表預覽、匯出、列印、填報功能測試通過。
• 查閱官方發布說明，確認是否有破壞性變更需調整模板。

常見坑點提醒

• JAR 放錯目錄 → 設計器無法啟動或功能缺失。
• 舊版 JAR 未刪除 → 類別載入衝突，功能異常難排查。
• 設計器與伺服器版本號不一致 → 模板部署後樣式錯亂、資料集失效。
• 未備份模板 → 升級後不相容導致模板損壞無法回滾。

遵循「備份先行、版本對齊、分層升級、充分測試」原則，FineReport 升級即可平穩完成，持續享受最新功能紅利。