症狀｜Shopify Flow 顯示工作流程失敗，或執行一直沒有完成，你不確定該先改設定還是重跑。
本週先做｜打開該次執行的詳細記錄，記下失敗步驟與錯誤訊息，再分類處理；資料或設定、權限、暫時錯誤的修法不同。修正後依 Shopify 官方條件判斷是否重試。遠端 Mac 不能修復 Flow 的服務端錯誤，只有要重現 macOS 瀏覽器介面問題時才可能派上用場。
適合正在處理商品、訂單或客戶自動化異常的店鋪營運人員，以及需要確認錯誤位置的管理員。
如果問題只在 Mac 瀏覽器中的 Shopify 後台介面重現，測試協作者也可參考文中的瀏覽器復測邊界。
先看執行記錄，再決定是否改工作流程
遇到 Shopify Flow 工作流程失敗，第一步不是停用後重建，也不是立刻重跑，而是先確認這一次執行發生了什麼。Shopify 的執行監控說明提供檢視執行記錄的官方路徑；實際後台的選單文字若有調整，請以目前介面為準。
開啟問題工作流程的執行記錄，選取出現異常的那次執行，查看狀態、失敗步驟和完整錯誤訊息。將這些資訊連同發生時間與相關訂單或商品識別資訊一併記下，之後才容易區分是未觸發、仍在執行，還是已經失敗。
判斷時可用三類證據交叉核對：觸發器提供了什麼資料、出錯動作要求什麼資料，以及執行詳情指出哪裡出錯。Shopify 說明了觸發器如何啟動工作流程，因此若執行根本沒有開始，應先核對觸發條件及事件是否符合預期，而不是只檢查最後一個動作。
資料或資源不吻合，先對照上下游
常見的配置問題是後續動作需要某項資源，但前面的觸發器或條件沒有提供該資料；另一種情況是動作預期取得單一資源，實際收到的卻是清單，或反過來。Shopify 的Flow 錯誤排查說明列出工作流程錯誤的處理方向；你應依執行詳情逐步檢查，而不要將某一種錯誤套用到所有失敗案例。
例如，你設定訂單成立後更新商品標籤，但執行資料沒有提供動作所需的商品資訊，問題就不一定在標籤本身。回到該次執行的觸發器輸出，確認資料是否存在、欄位是否可用，再沿著條件和動作往下對照。
如果輸入的是多筆資料，檢查後續動作是否能處理清單。只有當流程確實需要逐筆處理時，才調整循環或前置查詢；不要為了消除錯誤而盲目新增步驟，否則可能讓本來精簡的流程變得難以驗證。需要隔離測試時，可參照官方的工作流程測試說明，並留意測試結果不等於實際店鋪資源已按預期更新。
權限不足與配置錯誤，處理責任不同
如果你無法開啟 Flow、執行測試、查看執行詳情或啟用工作流程，先記錄自己在哪個操作環節遇到限制。不同操作所需的存取權限可能不同；請把錯誤提示、工作流程名稱和受限操作交給有權限的店鋪管理員核對，不要把後台授權問題誤判為瀏覽器故障。
管理員可依 Shopify 的Flow 員工權限說明檢查帳號是否具有相關存取權，並核對錯誤是否涉及店鋪資料、應用程式或密鑰權限。若錯誤明確指出某項資料或應用程式不可存取，先處理授權，再回到同一操作驗證；換裝置不會自動改變帳號權限。
權限問題應由有權限的管理員按需要授權，不要為了讓測試通過而擴大不必要的存取範圍；留下授權原因與涉及的流程，也方便日後檢查。
長時間執行或反覆失敗，先辨認暫時與持續性問題
單次伺服器錯誤不能直接證明工作流程設定有問題。先看該次執行的錯誤提示，再確認是否有其他執行也在相同步驟失敗。若只出現一次，應依官方錯誤排查說明判斷是否屬於暫時異常；若問題反覆發生，則要檢查查詢範圍、清單處理和動作所需資料，避免只靠重試掩蓋根因。
若執行停留很久，特別留意是否有清單循環，或某個查詢取得的資料遠多於該動作需要的範圍。逐步縮小查詢條件，並確認每一步輸入輸出是否符合流程目的。Shopify 官方資料沒有為你的店鋪保證特定執行時間；因此應以該次執行記錄和重複出錯位置作判斷，不要只憑「看起來很慢」認定是服務端故障。
遇到持續錯誤時，保留執行詳情、錯誤訊息和受影響資源，再依官方排障方式逐項核對。避免在尚未確認重複執行後果前，多次執行會更新訂單、標籤或客戶資料的動作。
修復後先核對條件，再手動重試
修復設定或取得所需權限後，不代表任何失敗執行都可以直接重跑。依 Shopify 的手動重試條件與步驟確認該次執行是否符合重試條件，以及重試會使用哪些執行資料。若問題涉及觸發器沒有產生預期事件，應先處理觸發條件；手動執行工作流程和重試失敗執行也不是相同操作，可參照手動執行工作流程說明區分。
重試後回到執行記錄確認結果，再到相應的訂單、商品或客戶頁面核對實際狀態。記錄顯示工作流程完成，不等於店鋪資料必然正確；例如，動作確實執行，但條件選錯或輸入資料不符業務規則，結果仍可能不是你要的。
重試前可勾選清單
- [ ] 已找到失敗的那次執行，並記下狀態、步驟與完整錯誤訊息。
- [ ] 已確認工作流程是否有觸發，以及觸發器輸出是否包含後續動作所需資料。
- [ ] 已檢查資源類型與數量是否相符，並確認清單處理符合流程目的。
- [ ] 若遇到權限錯誤，已請管理員核對所需資料、應用程式或密鑰存取權。
- [ ] 已修正根因，並確認該次執行符合官方手動重試條件。
- [ ] 重試後會再核對執行記錄及實際店鋪資源，而非只看成功狀態。
只有介面問題才需要比較 Mac 瀏覽器復測
Shopify Flow 的執行記錄出現服務端錯誤、資料缺失或權限不足時，改用 Mac 不會修復工作流程本身。遠端 Mac 的用途限於另一種問題：你懷疑錯誤出現在 macOS 瀏覽器中的 Shopify 後台畫面，例如操作介面顯示異常，並需要在相同作業系統與瀏覽器環境重現。
| 問題類型 | 優先處理方式 | Mac 瀏覽器復測的適用性 |
|---|---|---|
| 觸發器未啟動或執行資料缺漏 | 核對觸發事件、條件與輸出資料 | 無法補上服務端資料或修正流程 |
| 動作要求的資源不符 | 對照錯誤步驟、資源類型與清單處理 | 不能取代 Flow 配置排查 |
| 無法開啟、測試或啟用 | 請管理員核對帳號與應用程式權限 | 更換裝置不會改變帳號授權 |
| 只有 macOS 瀏覽器畫面異常 | 在相同瀏覽器環境重現，記下頁面表現與操作步驟 | 可協助分離介面問題與工作流程錯誤 |
若團隊要在 macOS Safari 確認後台畫面，應記錄瀏覽器、頁面位置、操作順序與實際表現，並與 Flow 執行錯誤分開保存。這些是測試記錄應包含的項目，不代表此處已有任何本站實測結果。你也可先查看OSXPort 使用指南，了解遠端 Mac 的一般使用方式。
常見問題
Shopify Flow 的錯誤細節應從哪裡找？
從發生異常的工作流程進入執行監控，選取對應執行並查看錯誤步驟及完整訊息。若找不到執行記錄，先確認工作流程是否真的被觸發；若仍無法查看，再檢查帳號是否有相應權限。不要只憑工作流程已啟用，就推斷這次任務必定已執行。
顯示權限錯誤時，應交由誰處理？
請找店鋪管理員核對實際需要的工作流程、店鋪資料或應用程式存取權。提供錯誤出現在哪個操作環節，以及畫面顯示的訊息；管理員再依權限說明判斷是否需要授權。更換瀏覽器、電腦或網路連線，不能取代後台授權。
修好設定後，失敗的執行是否都能重試？
不一定。先確認失敗原因已修正，再按 Shopify 官方手動重試條件檢查該次執行是否適用。對會改動店鋪資料的工作流程，還要考慮重複處理的影響；重試後同時檢查執行結果與實際資源狀態，避免把「執行完成」當成業務結果正確的證明。
工作流程一直執行或反覆失敗，應如何處理？
對照執行詳情中的步驟與錯誤，先分清等待中的執行、資料或清單處理問題，以及可能的暫時性異常。若重複卡在相同位置，檢查查詢範圍、循環和所需資料；若單次出現伺服器錯誤，不要未核實便認定配置故障。持續失敗時，保留記錄後按官方排障方式處理。
若失敗只出現在 Flow 執行記錄，依問題類型處理資料、配置、權限或暫時錯誤，比換設備更直接。相較於沿用個人電腦、臨時切換裝置或反覆重試，這些做法可能難以固定瀏覽器環境、重現步驟也較不一致，而且都無法解決服務端或權限問題。若你還需要在 macOS Safari 重現 Shopify 後台介面問題，租用 OSXPort 的遠端 Mac 可提供獨立的 Mac 測試環境；但若只要處理 Flow 執行錯誤，應優先留在官方排障路徑。可按實際測試需求查看 OSXPort 的 Mac 方案。
常見問題
Shopify Flow 的錯誤細節要到哪裡查看？
先進入 Shopify Flow，開啟發生異常的工作流程，再從執行監控或執行記錄選取對應的一次執行。檢查狀態、失敗步驟和錯誤訊息，並記下觸發器輸出與出錯動作；不要只看工作流程是否已啟用，因為已啟用不代表該次執行成功。
Flow 顯示權限不足，應該交由誰處理？
請先確認錯誤發生在開啟 Flow、測試、查看執行詳情，還是啟用工作流程時，再把缺少的店鋪資料、應用程式或密鑰存取權限告知店鋪管理員。管理員應依實際權限設定核對並授權；更換電腦或瀏覽器通常不能補上後台帳號權限。
修正失敗原因後，可以直接重跑原本的工作流程嗎？
先確認根因已修正，再查看 Shopify 官方的手動重試條件，判斷該次失敗執行是否適用。重試後重新檢查執行記錄和受影響的訂單、商品或客戶資料；記錄顯示成功，只能說明工作流程執行完成，不能單獨證明業務資料符合你的預期。
工作流程一直執行或重複失敗，排查順序是什麼？
從執行詳情中的目前步驟與錯誤提示開始，分辨是等待中的執行、資料量或清單處理造成的延遲，還是服務端暫時異常。若牽涉清單循環或查詢範圍，檢查是否不必要地處理過多資料；若錯誤持續出現，保留執行資訊並按官方排障說明處理，不要只靠反覆重試。