# 建置與部署問題

## 雲端建置失敗並出現物件錯誤

可能的原因

一或多個物件無法在 Qlik Sense 中建立。主控台顯示 `Build failed`，接著是錯誤的描述。當物件屬性不受目標視覺化類型支援時，通常會發生此失敗。

建議的行動

在 Qlik Sense 中開啟應用程式以檢閱受影響的物件。應用程式已建立，並成功載入大部分物件。檢查 Excel 轉換報告中結果為 錯誤 的物件。這些物件需要在 Qlik Sense 應用程式編輯器中手動更正。檢閱位於 `logs/` 輸出子資料夾中的每次執行記錄檔，以取得完整的錯誤詳細資料。

## 媒體上傳失敗

可能的原因

一或多個影像檔案無法上傳至 Qlik Sense 媒體庫。主控台顯示 `Media upload failed for N/M file(s)`，接著是第一個失敗的詳細資訊。

建議的行動

驗證影像檔案存在且未損毀。檢查檔案大小，因為非常大的圖片可能會超出上傳限制。重試部署。如果問題持續存在，請透過 Qlik Sense 媒體庫手動上傳影像。執行 `--logLevel DEBUG` 以識別日誌輸出中哪些檔案失敗。

## 暫時的自動二進位應用程式在失敗的部署後殘留

可能的原因

QVW 檔案上傳至 Qlik Cloud 後，建置或重新載入步驟失敗。QV2QS 會嘗試自動刪除暫時的應用程式，但如果網路連線中斷或 API 金鑰已過期，清理可能會失敗。

建議的行動

檢查目標空間中是否有以下名稱的應用程式：`QV2QS_Binary_YYYYMMDD_HHMMSS`（例如，`QV2QS_Binary_20260219_143025`）並手動刪除它們。重新執行轉換以重新產生輸出檔案。檢閱每次執行的記錄檔，位於`logs/`輸出子資料夾中，以取得清除錯誤的詳細資訊。

## 工作表在重新部署到現有的應用程式後消失

可能的原因

工作表準備步驟中途失敗。QV2QS 會在建置之前，從雲端應用程式中移除現有的工作表，以便能以相同的 ID 建立新的工作表。如果移除或建置步驟失敗，應用程式可能會處於不完整的狀態。

建議的行動

從自動部署前備份復原應用程式。備份會儲存到 `cloud/backups/` 專案輸出資料夾中。透過 Qlik Cloud 中心，將備份的 QVF 匯入目標空間。然後重新執行部署。如果沒有可用的備份，請透過省略`--reuseAppId`和`--appId`，將轉換重新執行為新的應用程式。

## 新工作表在重新部署到現有的應用程式後未發佈

可能的原因

發佈工作表 設定在重新部署期間已停用。當重複使用現有的應用程式時，QV2QS 會自動還原先前部署工作表的發佈狀態，但新工作表只會在發佈工作表設定啟用時才會發佈。

建議的行動

重新執行部署，並啟用發佈工作表 (預設值)。或者，您也可以手動將新工作表發佈到 Qlik Cloud。開啟應用程式，用滑鼠右鍵按一下每個未發佈的工作表，並選擇發佈。

## 了解更多

* [建置與部署](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/build-and-deployment.htm)
* [重複使用現有的應用程式](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/reusing-an-existing-app.htm)
* [Qlik Cloud 資源限制](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/known-limitations/qlik-cloud-resource-limits.htm)
* [轉換報告](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)