建置與部署問題
上次更新：2026/10/14雲端建置失敗並出現物件錯誤
可能的原因
一或多個物件無法在 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。開啟應用程式，用滑鼠右鍵按一下每個未發佈的工作表，並選擇發佈。