# 疑難排解

診斷並解決在轉換和部署期間遇到的常見問題。每個問題都遵循「可能原因 / 建議措施」模式。

* [精靈與啟動問題](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/troubleshooting/wizard-and-startup-issues.htm) — 解決 UI 元件故障和連接埠衝突。
* [QlikView Desktop 問題](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/troubleshooting/qlikview-desktop-issues.htm) — 解決 QlikView 實例衝突以及 PRJ 產生逾時。
* [Qlik Cloud 連線問題](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/troubleshooting/qlik-cloud-connection-issues.htm) — 解決驗證失敗、API 金鑰問題、角色設定錯誤以及內容衝突。
* [建置與部署問題](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/troubleshooting/build-and-deployment-issues.htm) — 解決雲端建置錯誤和媒體上傳失敗。
* [轉換輸出問題](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/troubleshooting/conversion-output-issues.htm) — 解決預留位置物件、批次失敗、非預期的維度或量值，以及字型差異。

## 應優先檢查哪個日誌

QV2QS 寫入兩個獨立的日誌。系統日誌在 `%LOCALAPPDATA%\QV2QS\qv2qs.log` 始終會寫入，從程序啟動的那一刻起。輸出目錄中的每次執行日誌，僅在命令列引數解析完成且輸出資料夾初始化之後才會建立。

* 如果程序崩潰或在產生輸出前退出，請檢查系統日誌。執行日誌尚不存在。
* 如果轉換執行但產生非預期的結果，請檢查輸出目錄的`logs/`子資料夾中的每次執行記錄。
* 如果 批次執行顯示失敗檔案但沒有錯誤詳細資料，請檢查系統日誌中是否有批次層級錯誤，例如 QlikView Desktop 遺失或先決條件失敗。

如需日誌位置、格式以及兩種日誌之間重疊部分的完整指南，請參閱[日誌記錄與診斷](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm)。

## 啟用診斷記錄

使用 `--logLevel DEBUG` 執行轉換，以記錄轉換決策、雲端 API 呼叫、引擎探索步驟和物件處理詳細資料。偵錯層級的項目會同時顯示在系統記錄和每次執行記錄中 (如果可用)。

## 了解更多

* [日誌記錄與診斷](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm)
* [開始使用](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/index.htm)
* [部署至 Qlik Cloud](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)
* [已知限制](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/known-limitations/index.htm)