遠程設計常見問題

1

查看是否支援遠程設計。

1. 場景描述：遠程設計連結前，需要先確認遠程的工程是否支援遠程設計功能點。

2. 解決方案：登入數據決策系統，查看http://IP:port/webroot/decision/remote/design/vt的返回值，若返回{"data":"success"}，代表支援。

2

查看使用者權限。

1. 場景描述：非超管賬戶遠程設計連結失敗。

2. 解決方案：超管登入數據決策系統，查看是否為使用者分配了遠程設計的權限，詳情請參見：遠程設計 。

3

查看JAR包版本。

1. 場景描述：本地設計器版本和遠程JAR包版本不一致，會導致很多問題。

2. 解決方案：遠程連結時，若版本不匹配，會提示版本不一致，遠程設計時部分功能將受影響。如下圖所示。建議及時更新，保證伺服器和設計器版本一致。版本相關說明詳見：升级指南。

1

帳號密碼錯誤。

1. 問題簡介：遠程設計連結時，提示【帳號密碼錯誤】。

2. 解決方案：填寫的帳號和密碼，沒有遠程設計的權限，需要聯絡管理者新增，詳情請參見：遠程設計 。

2

報錯【Response HTTP/1.1 404 by 】。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計連結時報錯：【com.fr.workspace.engine.exception.WorkspaceConnectionException: Response HTTP/1.1 404 by  http://IP:埠號/webroot/decision】。

3. 解決方案：卸載重裝設計器。

3

報錯【The SolidRecordExecutor should be register first】。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計連結時報錯：【The SolidRecordExecutor should be register first】。

3. 原因分析：伺服器沒有安裝雲端健檢分析插件，不影響功能的正常使用。這個是伺服器上埋點功能相關的報錯，只不過是透過遠程設計日誌推送推到設計器上展示，實際上與遠程設計功能本身無關。

4

遠程設計偶發連結失敗。

1. 問題簡介：遠程設計連結偶發出現連結失敗的情況，設計器頁面會出現遠程本地主機強迫關閉了一個現有的連結，就無法連結到伺服器了。

2. 原因分析：Tomcat中配置了一個連結逾時時間connectionTimeout，如果在這個時間之後使用者端還未得到伺服器端的響應的話，就會主動斷開連結，即出現上述異常了。

3. 解決方案：Tomcat中預設連結逾時時間是20秒，一般最好設定為60秒，進而避免後臺程式處理時間長導致連結斷開，修改如下：【connectionTimeout="60000"】。

5

遠程設計頻繁斷開。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計，頻繁斷開。

3. 排查方案：管理者登入數據決策系統，點擊【管理系統】→【智慧維運】→【記憶體管理】，查看【記憶體預警】Tab 下【記憶體利用率和【CPU 利用率】兩張圖是否顯示空白。若顯示空白，則說明 WebSocket 連結失敗，請參考文檔配置 WebSocket 埠：B14-06 Websocket未連結。

   檢查網路是否連通：ping                       ip位址是否聯通、檢查vpn是否有問題、檢查網路狀況。

6

配置了虛擬目錄的工程無法連結。

1. 問題簡介：使用者工程做了虛擬目錄配置，配置遠程設計連結是無法連結。

2. 解決方案：在虛擬目錄後面（即：Servlet處）加了/desicion，連結成功。

7

內網環境無法遠程設計連結伺服器。

1. 產品版本：FineReport 10.0。

2. 問題簡介：沒有做重定向和攔截設定，外網映射就正常連結，改成VPN內網之後使用者端遠程設計就出現連結失敗。

3. 日誌：【failed: Connection timed out: connect】。

4. 警告：【com.fr.workspace.engine.exception.WorkspaceConnectionException: remote design connect failure】。

5. 解決方案：VPN適配的問題，開啓VPN裏面使用者端連結的所有的權限即可。

1

報錯【doesn't match any of the subject alternative names 】。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計連結時報錯：【doesn't match any of the subject alternative names】。

3. 原因分析：是因為配置時使用的域名不是憑證生成時填寫的域名。

4. 解決方案：重新配置域名，測試，連結成功。

2

報錯【Unrecognized SSL message, plaintext connection? 】。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計連結時報錯：【Unrecognized SSL message, plaintext connection?】。

3. 解決方案：埠錯誤，提供的不是 https 服務的埠，詳情請參見：Unrecognized SSL message, plaintext connection?https请求遇到异常分析（本鏈接為網路方案，僅供參考）。

3

報錯【unable to find valid certification path to requested target】。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計連結時報錯：【sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target】。

3. 解決方案：詳情請參見：java 使用https协议,cas认证PKIX path building failed错误解决方法（本鏈接為網路方案，僅供參考）。

4

不支援免費ssl憑證。

1. 產品版本：FineReport 9.0。

2. 問題簡介：使用了阿里雲的免費ssl憑證，格式是pfx，配置好後直接存取位址可以進入決策平台，但是遠程設計連結失敗。

3. 解決方案：不支援免費的ssl憑證，可以先轉成.keystore憑證。

5

不支援crt憑證。

1. 產品版本：FineReport 8.0&9.0&10.0。

2. 問題簡介：遠程設計不支援 crt 憑證。

3. 解決方案：可以將crt轉換成jks的憑證。

6

遠程設計啟用https無法連結bi伺服器。

1. 問題簡介：參考文檔【配置 SSL 證書實現 HTTPS 訪問】，CAS 單點登入正常，但是遠程設計連結伺服器無法連結成功。

2. 原因分析：客戶本地主機的hosts檔案沒有配置域名導致無法本地透過域名存取到伺服器。

3. 解決方案：將本地主機的hosts檔案配置好正確的域名之後，重啓服務之後本地正常遠程設計連結。

1

伺服器已關閉。

1. 問題簡介：遠程連結測試是通的，切換到遠程設計後一直會彈出提示框，提示伺服器已關閉（實際是沒有關閉的）。

2. 解決方案：遠程設計要加上埠，如果是做了直接存取 ip 的設定，那一般是預設 80 埠。

2

請求被伺服器網路攔截。

1. 問題簡介：切換遠程目錄失敗 ，且設計器日誌中有類似報錯：【java.util.zip.ZipException: Not in GZIP format】。

2. 原因分析：遠程設計請求被伺服器網路攔截了。

3. 解決方案：請伺服器網路維運相關負責人，修改網路安全攔截策略，將/webroot/decision/remote/design/*相關請求加入白名單。

3

HTTP 411錯誤。

1. 問題簡介：遠程設計測試連，切換工作區間失敗，設計器日誌中有以下類似報錯：【com.fr.workspace.engine.exception.WorkspaceConnectionException: Response HTTP/1.1 411 Length Required by http://IP:埠/webroot/decision】。

2. 解決方案：確認 Nginx 版本，若低於 Nginx 1.3.9 版本，請給現有 Nginx 安裝 chunkin-nginx-module 修補，或升級 Nginx。

   設計器版本升級到 10.0.8 版本，遠程設計的 post 請求頭中已經加入了 Content-Length 。

4

【Nginx 504 Gateway Time-out】。

1. 問題簡介：遠程設計出現切換慢/操作卡，且設計器日誌中有類似報錯：【com.fr.workspace.engine.exception.WorkspaceConnectionException: Response HTTP/1.1 504 Gateway Time-out by 10.1.1.96:80】。

2. 原因分析：Nginx 504 Gateway Time-out的含義是所請求的網關沒有請求到，簡單來說就是沒有請求到可以執行的PHP-CGI。Nginx 504 Gateway Time-out一般與Nginx.conf的設定有關。

3. 解決方案：調整nginx.conf參數  重啓nginx生效。預設fastcgi進程響應的緩衝區是8K，可以調大以下參數：【fastcgi_buffer_size】 128k 。

   【fastcgi_buffers】 8 128k 。

   【fastcgi_busy_buffers_size】 由 128K 改為 256K 。

   【fastcgi_temp_file_write_size】 由 128K 改為 256K。

1

找不到範本。

1. 產品版本：FineReport 10.0。

2. 排查步驟：linux環境，檢查編碼，中文字型。

   查看登入功能點，是否有這個功能點。功能點介紹請見：B08-01 功能列表。

   檢查遠程設計使用者權限。

   檢查範本權限。

   檢查範本所屬的使用者組。

2

編輯範本儲存失敗。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程伺服器儲存範本時，報錯：【"xxx.cpt" is locked by user admin with client xxx】，client後的編號和設計器編號一致，但是遠程設計和激活碼是不限制的。

3. 原因分析：傳送的請求中只要包含了特定字串，那麼伺服器在讀取的時候就會發生【java.io.IOException: Connection reset by peer】 導致拿不到。這是伺服器網路問題，是某種 SQL 防注入安全策略。

4. 解決方案：請伺服器網路維運相關負責人，修改網路安全攔截策略，將/webroot/decision/remote/design/*相關請求加入白名單。

3

儲存範本提示沒有權限。

1. 問題簡介：使用超級管理者帳號遠程設計，儲存範本時出現以下現象：

   儲存範本，提示沒有權限。

   目錄有查看權限但不顯示。

   範本已儲存在伺服器環境，但依然提示【請將範本儲存在當前運作環境】。

   日誌中出現報錯：NoHttpResponseException。

2. 原因分析：服務端斷開了http連結，但並沒有通知使用者端，下次請求該服務時httpclient繼續使用該連結導致報錯。

3. 解決方案：更新設計器和工程至 10.0.12 及以後版本。

   調整tomcat配置：修改 Tomcat 的 server.xml 的 connectionTimeout ，調大後重啓生效。如下圖所示。

1

資料連結失敗。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計時，資料連結失敗，或者資料連結測試連結成功，但是建立資料庫查詢時顯示失敗。

3. 解決方案：檢查伺服器和設計器jar包是否一致，保持一致即可。JAR版本相關說明詳見：升級指南。

2

資料連結密碼為無。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計時，現有的資料連結密碼丟失，無法連結。重新填寫密碼後連結，都會報錯密碼為無。設計器日誌報錯【Decrypt failed:Decryption error】。

3. 解決方案：工程有祕鑰種檔案，在config下面，如default_alpha、default beta、default gamma，刪掉即可。

3

遠程設計無法看到 Excel 檔案。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計無法看到 Excel 檔案，這是需求，暫時無法支援。

4

遠程設計選不了json資料集。

1. 產品版本：FineReport 10.0。

2. 問題簡介：本地可以正常選到json資料集的連結，但是遠程設計下選不到。

3. 解決方案：關閉 遠程設計 。

1

範本開啟是建立的空白範本。

1. 問題簡介：遠程設計所有範本都無法開啟，所有範本開啟是建立的空白範本。

2. 原因分析：redis 存在髒數據。

3. 解決方案：清空redis，如果是使用redis叢集，每個節點都需要清空。

2

範本無法儲存。

1. 問題簡介：遠程設計時出現範本儲存不上，且伺服器日誌中有以下類似報錯：【java.lang.NullPointerException】。

2. 原因分析：redis 存在髒數據。

3. 解決方案：清空redis，如果是使用redis叢集，每個節點都需要清空。

3

切換遠程目錄卡慢，開啟報表卡死。

1. 問題簡介：遠程設計目錄切換速度很慢，開啟伺服器上範本直接卡死。

2. 排查方向：叢集環境，檢查 nginx 等配置是否正確，調整 nginx 的參數。

   查看 redis 狀態伺服器是否異常，重啓 redis 之後再次遠程。

4

叢集環境遠程設計連結LogDB查詢報錯。

1. 產品版本：FineReport 10.0。

2. 問題簡介：遠程設計連結後，資料集查詢 LogDB 中的表，匯出 SQL 時報錯。

3. 原因分析：Swift 取數限制導致。

4. 解決方案：JAR 包版本升級至 2020-12-11日之後刪除叢集節點中舊的 LogDB。

   清空 FineDB 中的 fine_swift_seg_location 和 fine_swift_segments 兩張表。

   重啓叢集節點。

1

遠程設計範本佔用（已被鎖定）的判斷機制。

1. 產品版本：FineReport 10.0。

2. 問題簡介：開啟了範本，重啓伺服器後開啟遠程工作區間發現範本已鎖定，但只有一個人在編輯。

3. 原因分析：範本鎖的釋放邏輯為每1分鐘清理下，判斷是否釋放的前提是該範本在1分鐘中沒有其他人操作。

4. 解決方案：重啓伺服器，或者等一段時間會被釋放。

2

遠程設計插件安裝邏輯。

1. 產品版本：FineReport 10.0。

2. 對於設計器和伺服器都會用到的插件，要求伺服器端和設計器端都要安裝：

   若設計器端已經有插件，伺服器端的插件下載、刪除、禁用 不會立即生效，需要等幾分鐘才會生效。

   若伺服器端有插件，設計器端沒有插件，則插件不會生效，需要切換到本地進行插件安裝。不過設計器切換到本地時對插件設定的“禁用”狀態不會影響到 遠程設計時的插件使用，遠程設計時，插件的狀態受伺服器控制。簡單理解就是只需要保證設計器本地有這個插件即可。插件安裝請見 A11-18 伺服器-插件管理。