設計器啟動守護

1. 應用場景：目前設計器啟動時，容易因為各種各樣的原因而卡死或者閃退，這種問題往往難以排查，又會給使用者帶來不好的使用體驗。

2. 為了處理設計器啟動問題，2020-04-26 版本的 JAR 包新增【設計器守護】功能。

1

設計器殘留進程佔用 FineDB。

1. 設計器啟動時如果彈出報錯提示資訊：【上次設計器進程未正常關閉，是否結束進程並重啓】，表示設計器上次啟動的進程未結束。

2. 點擊【結束進程】：結束顯示的進程並重啓設計器。

3. 點擊【取消】或【關閉】：取消設計器啟動。

2

埠被其他進程佔用。

1. 設計器啟動時如果彈出報錯提示資訊：【發現與設計器埠衝突的進程，請結束進程或更改設計器埠】，表示設計器的埠被其他進程佔用。

2. 點擊【更改埠】：另外彈框進行埠的修改，埠修改成功並確定後重啓設計器。

3. 點擊【結束進程】或【關閉】：取消設計器啟動。

4. 點擊【更改埠】後，彈出更改埠號的提示框，使用者可以在正文框中填寫新的埠號。

注1：設計器內建伺服器埠預設為 8075，點擊設計器中的預覽方式查看報表時使用這個埠；51462 為設計器預設埠，用來防止設計器多開。所以更改埠號時應避免填寫這兩個埠，以防填寫重複值再次導致衝突。

注2：埠號範圍在 1024~65535 之間。

3

FineDB 損壞。

1. 設計器啟動時如果彈出下彈出報錯資訊：【配置資料庫出錯，是否重置？將在embed檔案夾生成備份並重置】，表示 FineDB 會因為某些原因存在損壞的情況，導致設計器啟動失敗。

2. 點擊重置：刪除 FineDB ，並在 embed 下生成備份檔案夾 finedb_bak ，隨後繼續啟動。

3. 點擊【取消】或【】關閉：關閉設計器啟動進程。

注1：FineDB 損壞重置之後，生成的 FineDB 是沒有資料的 ，重置須謹慎。

注2：刪除 FineDB 檔案夾和備份都不行，最後是以管理者身分重啓報表工具。可以不用刪除 FineDB 檔案夾，點擊【取消】或關閉以管理者身分重啓報表工具。

4

遠程設計伺服器無響應。

1. 設計器啟動時如果彈出報錯提示資訊：【遠程連結時間過長是否繼續等待？】，表示設計器上次是在遠程設計狀態下關閉的，再次啟動時，如果伺服器直接關閉或者連不上時，會直接彈窗讓使用者切換工作區間，但是如果伺服器處於當機等情況時，遠程連結就會一直等待，導致設計器一直卡在啟動介面，而且沒有預設逾時設定。

2. 點擊【繼續等待】：關閉彈窗重新計算一分鐘，一分鐘後重復提示。

3. 點擊【切換目錄】：關閉彈窗，彈出遠程連結失敗後切換工作區間的視窗。

5

未知啟動問題。

1. 設計器啟動遇到未知錯誤時，會彈出報錯提示資訊：【抱歉！設計器啟動出現預期外的錯誤】，問題詳細資訊顯示：【預期外的啟動錯誤】。

2. 點擊重啓：重新啟動設計器。

3. 點擊好：同時關閉彈窗和設計器。

4. 點擊左上角關閉：只關閉彈窗。

注：該彈窗只有 Windows 版本的設計器有，macOS 版本的設計器沒有該彈窗。

6

設計器閃退。

1. 設計器發生閃退時，會彈出報錯提示資訊：【抱歉！設計器啟動出現預期外的錯誤】，問題詳細資訊顯示：【預期外的閃退錯誤】。

2. 點擊【重啓】：重新啟動設計器。

3. 點擊【好】或【關閉】：關閉設計器啟動進程。

注：該彈窗只有 Windows 版本的設計器有，macOS 版本的設計器沒有該彈窗。

7

finereportEnv.xml 檔案損壞。

1. 設計器啟動失敗，彈出報錯提示資訊：【抱歉！設計器啟動出現預期外的錯誤】，問題詳細資訊顯示：【-1】，如下圖1所示。

2. 這是由於系統槽 .FineReport100 檔案夾內的 finereportEnv.xml 檔案損壞導致的，刪除該檔案即可，如下圖2所示。