# 精靈與啟動問題

## 連接埠已被使用

可能的原因

另一個 QV2QS 實例或另一個應用程式正在使用相同的網路連接埠。主控台顯示 `ERROR: Port [number] is already in use.`

建議的行動

關閉其他應用程式，或使用 `--port` 指定不同的連接埠。使用 `--port 0` 讓系統自動選取可用的連接埠。

## 精靈在 Internet Explorer 中開啟或無法正確呈現

可能的原因

Internet Explorer 是機器上的預設瀏覽器。QV2QS 使用者介面需要現代瀏覽器，且無法在 Internet Explorer 中運作。

建議的行動

安裝 Google Chrome、Microsoft Edge 或 Mozilla Firefox。QV2QS 在啟動時偵測預設瀏覽器，並在有可用的瀏覽器時自動開啟支援的瀏覽器。如果找不到支援的瀏覽器，主控台會顯示下載連結。

在 Windows Server 2019 上，Internet Explorer 是唯一預設安裝的瀏覽器。請先安裝支援的瀏覽器，再以精靈模式執行 QV2QS。或者，使用命令列介面，它不需要瀏覽器。請參閱 [引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm) 以取得 CLI 引數的完整清單。

## 轉換失敗或在精靈中產生非預期的結果

可能的原因

精靈會顯示摘要錯誤，但不會公開找出根本原因所需的完整診斷詳細資料。

建議的行動

從命令列重新執行相同的轉換，並啟用偵錯記錄。請執行下列動作：

1. 在精靈中，導覽至檢閱步驟。
2. 按一下複製命令以將完整的 CLI 命令複製到剪貼簿。
3. 開啟終端機視窗並貼上已複製的指令。
4. 將 `--logLevel DEBUG` 附加到指令的末尾，然後按下 Enter 鍵。

主控台顯示詳細輸出，涵蓋每個轉換決策、雲端 API 呼叫，以及物件處理步驟。完整的偵錯日誌也會寫入到輸出目錄中的 `logs/` 子資料夾。

提示備註

複製的命令包含在精靈中設定的所有設定。附加 `--logLevel DEBUG` 是啟用完整診斷所需的唯一變更。

請參閱[記錄與診斷](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm)以了解記錄檔格式和位置。

## QV2QS 已停止 強制回應視窗出現在瀏覽器中

可能的原因

QV2QS 程序已關閉、崩潰或終止，而精靈仍在瀏覽器中開啟。使用者介面透過定期健康檢查監控後端服務，並在服務無法連線時顯示彈出視窗。

建議的行動

執行下列其中一個動作：

* 重新連線至目前的會話。複製在彈出視窗中顯示的指令，並在終端機中執行該指令。此命令包含`--port`和`--noBrowser`，以重新連接到相同連接埠上的相同瀏覽器分頁。伺服器啟動後，在彈出視窗中點擊重新連線。精靈會繼續，所有先前輸入的設定都會保持不變。
* 關閉瀏覽器分頁。點擊 關閉視窗 在彈出視窗中。目前精靈工作階段中任何未儲存的設定都將遺失。

## 範例專案檔遺失或損毀

可能的原因

範例 QVW 檔案在 `%TEMP%\QV2QS\examples\` 已被刪除、移動或在 QV2QS 外部修改。

建議的行動

從 `%TEMP%\QV2QS\examples\` 刪除受影響的檔案，然後重新啟動 QV2QS。啟動時會自動提取一份全新的副本。若要保留範例檔案的永久副本，請在修改前將檔案複製到本機工作資料夾。請參閱[範例專案](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)。

## 了解更多

* [快速入門](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/quick-start.htm)
* [範例專案](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)
* [精靈步驟](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm)