CubeLV 平台 Bug 回報：上架組合包打包超時觸發 HTTP 504 未進入 AI 審核

由 蔡其樺 分享的筆記

錯誤代碼 504 Gateway Timeout超時中斷 發生時機 打包中 點擊上架後等待期間 AI 審核 未進入 無任務、無紀錄無退回原因 影響 阻斷 大包必現重試同樣失敗 核心判斷 這不是 AI 審核被拒，是連審核都沒排進去。 504 發生在 Gateway 層，打包請求在單一 HTTP 連線內同步執行、超過 upstream timeout（常見 30s / 60s）就被切斷，後端審核服務根本沒收到任務。 一、現象 於市集執行「上架組合包」後，前端長時間轉圈、無進度提示，最終彈出 504 Gateway Timeout 。檢查後台：無 AI 審核任務、無審核結果、無可重送審的入口，狀態回到未送審。 504 錯誤發生在打包階段，非審核階段 組合包內容越多 / 檔案越大，越容易復現（打包耗時與體積正相關） 重試相同組合包 → 同樣 504，無法靠重試自癒 使用者無法區分是網路問題、打包失敗還是審核失敗 二、重現步驟（推估） 準備較大的組合包 含多個插件 / 檔案，或單檔體積較大，觸發較長的打包/壓縮/校驗時間 執行上架 市集 → 組合包 → 上架，觀察請求開始後長時間無回應 等待至 Gateway 超時門檻 數十秒後（依 LB/Nginx 設定常見 30s / 60s / 120s）回應 504 檢查後台 審核中心 / 任務清單：無對應 AI 審核紀錄，視為從未送審 三、實際 vs 預期 項目 實際行為 預期行為 打包 同步阻塞在單一 HTTP 請求內，超時即全中斷 非同步背景任務，前端輪詢或訂閱進度 超時處理 直接拋 504 給前端，無 taskId、無續查入口 超時前回 { taskId } ，背景續跑；或提供明確錯誤文案 AI 審核 完全未觸發 打包完成後自動進入 AI 審核佇列 使用者回饋 只有 504，看不出是打包慢還是審核問題 明確狀態機：打包中 → 已送審…