疑難排解
上次更新：2026/10/14診斷並解決在轉換和部署期間遇到的常見問題。每個問題都遵循「可能原因 / 建議措施」模式。
- 精靈與啟動問題 — 解決 UI 元件故障和連接埠衝突。
- QlikView Desktop 問題 — 解決 QlikView 實例衝突以及 PRJ 產生逾時。
- Qlik Cloud 連線問題 — 解決驗證失敗、API 金鑰問題、角色設定錯誤以及內容衝突。
- 建置與部署問題 — 解決雲端建置錯誤和媒體上傳失敗。
- 轉換輸出問題 — 解決預留位置物件、批次失敗、非預期的維度或量值，以及字型差異。
應優先檢查哪個日誌
QV2QS 寫入兩個獨立的日誌。系統日誌在 %LOCALAPPDATA%\QV2QS\qv2qs.log 始終會寫入，從程序啟動的那一刻起。輸出目錄中的每次執行日誌，僅在命令列引數解析完成且輸出資料夾初始化之後才會建立。
- 如果程序崩潰或在產生輸出前退出，請檢查系統日誌。執行日誌尚不存在。
- 如果轉換執行但產生非預期的結果，請檢查輸出目錄的
logs/子資料夾中的每次執行記錄。 - 如果 批次執行顯示失敗檔案但沒有錯誤詳細資料，請檢查系統日誌中是否有批次層級錯誤，例如 QlikView Desktop 遺失或先決條件失敗。
如需日誌位置、格式以及兩種日誌之間重疊部分的完整指南，請參閱日誌記錄與診斷。
啟用診斷記錄
使用 --logLevel DEBUG 執行轉換，以記錄轉換決策、雲端 API 呼叫、引擎探索步驟和物件處理詳細資料。偵錯層級的項目會同時顯示在系統記錄和每次執行記錄中 (如果可用)。