先查看 Shopify Flow 的运行记录和失败步骤，再区分数据或配置错误、权限不足与临时异常；修复问题后，按官方条件判断是否重试。本周先为失败运行记录错误步骤、状态和提示，再处理配置，别一上来就重复启用工作流。只有问题发生在 macOS 浏览器界面时，远程 Mac 才可能帮助复现；它不能修复 Flow 服务端错误或后台授权。
这篇文章适合正在定位工作流失败位置的跨境店铺运营人员，也适合管理商品、订单或客户自动化的管理员。
如果你需要复现 macOS 浏览器中的 Shopify 后台界面问题，也可以据此判断：这是浏览器表现，还是工作流本身的故障。
先判定运行状态，再决定是否改工作流
打开 Shopify 后台的 Apps > Flow，进入 Recent runs。你可以从全部工作流的运行列表筛选，也可以打开目标工作流后查看它自己的运行记录；再按工作流名称、错误状态、开始时间或订单等资源信息缩小范围。查看 Shopify Flow 运行记录与监控方式
打开目标记录后，先看顶部状态和错误步骤，再展开对应步骤的数据。记录下触发器、失败步骤、完整错误提示、资源 ID，以及这次运行是否执行过其他动作。日志展示的是实际运行路径，不是对业务意图的猜测；如果记录没有显示预期字段，也要检查工作流是否在运行时就使用了该字段。
| 运行记录表现 | 优先检查 | 下一步 |
|---|---|---|
| 找不到预期运行记录 | 触发器是否匹配实际事件、筛选时间和工作流名称是否正确 | 查触发器定义，并扩大或修正筛选条件 |
| 显示 In progress 或 retrying | 是否是临时错误、超时或限流 | 打开失败或重试步骤，检查提示与数据范围 |
| 显示 Failed | 具体失败步骤、资源数据和权限要求 | 按错误类型修复，不要直接重复启用 |
| 显示 Completed，但业务结果不对 | 哪些动作实际执行，资源是否符合条件 | 回到订单、商品或客户页面核验结果 |
运行记录并非永久保存：Shopify 官方说明，已完成的运行记录保留 14 天，超期后会从系统移除。近期结果也可能稍晚才显示；如果日志里暂时没有新运行，先核对触发时间与时区，稍后再查，不要立即用相同事件反复触发。Shopify Flow 运行监控说明
提醒：“没有看到运行记录”不等于“工作流执行失败”。先核实触发器是否收到了预期事件，再检查记录筛选和显示延迟。
数据或资源不匹配：检查动作拿到的是什么
如果错误提示指向资源 ID 缺失、字段为空，或某个动作拿不到预期对象，先对照触发器输出与动作所需资源。比如，动作需要客户资源，但该次订单没有关联客户，后续“添加客户标签”就可能因为缺少客户 ID 而失败。针对这种情况，按业务意图加上资源存在条件，或把不依赖客户资源的动作安排在另一条可执行路径中。Shopify Flow 错误排查说明
还要留意“单个资源”和“资源列表”并不相同。触发器提供一个订单，不代表工作流自动拥有订单中的每个商品字段；要处理列表中的多个项目时，确认相关数据已被提供，并按实际逻辑选择循环或调整查询。反过来，如果动作只需一个目标对象，却对整张列表进行不必要的检查，就可能增加处理负担。
触发器本身也可能选错。Shopify 对触发器有明确区分，例如“订单创建”和“订单交易创建”代表不同事件；你要先确认实际业务事件符合触发器定义，而不是仅凭名称相似推定它们等价。核对 Shopify Flow 触发器的定义
权限提示：换设备无效，向管理员申请缺项
如果你能打开 Flow，却不能测试工作流、查看运行步骤、启用工作流或执行重试，先把它当作权限问题处理。相关权限可能分别涉及 Flow 自动化、工作流读取或修改的店铺数据、第三方应用，以及工作流使用的密钥；同一个员工可以查看一个工作流，却因缺少另一项数据或应用权限而无法操作另一个。
在权限提示中查看缺少的项目，并使用 Request access 向店铺管理员申请；如果没有对应入口，就把工作流名称、受阻操作和错误提示发给店铺所有者或有权管理角色的管理员。管理员应按工作流具体步骤核对权限，而不是只确认你能登录后台。Shopify 也说明，测试或查看步骤数据需要相应的店铺数据和应用权限；使用密钥时，还需要管理连接与密钥的权限。Shopify Flow 员工权限说明
如果你只是想验证修改后的逻辑，可用 Flow 的测试方式检查变量、条件和路径；但测试会在第一个会更改工作流逻辑的动作处停止，不会代替真实运行去更新店铺数据。因此，测试结果适合确认逻辑，不代表订单或商品已经完成预期变更。Shopify Flow 工作流测试说明
临时错误与持续异常：区分等待、超时和配置故障
Flow 将运行错误区分为临时错误和永久错误。临时错误会自动重试，运行记录可能长时间显示仍在运行；永久错误则无法通过自动重试解决，需要修复导致失败的条件或资源。Shopify 说明，不含等待步骤的工作流部分，以及等待步骤之间各自的部分，执行上限为 36 小时；达到上限仍未完成，运行会失败。Shopify Flow 错误类型与排查方法
如果出现 Step timed out，重点检查该步骤是否查询或遍历过多数据，特别是嵌套列表和循环；缩小数据范围，避免每次运行都遍历与本次订单无关的商品或字段。出现 GraphQL throttled 时，先检查循环是否处理了过大的列表、条件是否展开了过多字段，或工作流是否意外触发新运行形成循环。
对于 5XX 错误，单次出现不能直接证明配置有问题；官方排障说明将 500 至 599 的状态码归为这类响应，并指出它可能与网络或服务器问题有关。若同一错误在多次运行中反复出现，再对照失败步骤检查服务端或关联应用，并保留运行记录供进一步排查。
经验判断：如果多次运行都卡在同一个列表查询或同一动作，优先缩小查询范围；如果只有一次服务器错误，先保留记录并观察后续运行，不要据此重建整条工作流。
修复后先验条件，再执行 Shopify 工作流重试
手动重试并不是“把失败记录再跑一遍”这么简单。先修复原错误，再确认原运行不处于执行或等待状态、关联工作流已启用，而且触发器仍与原运行一致。Shopify 说明，手动重试会使用原运行的触发数据；但工作流中的 Get data 动作会重新获取最新数据，因此重试前要考虑资源状态已经变化的情况。Shopify Flow 手动重试条件与步骤
完成修复后，按这个顺序复核：
- 回到原运行详情，确认失败步骤对应的问题已修复。
- 检查触发器、工作流启用状态，以及运行是否已结束。
- 若触发数据关联的订单、商品或客户已变化，判断重试会不会基于新数据执行不合适的动作。
- 从运行详情页或工作流汇总页发起重试，并记录新运行与原运行的关联。
- 打开新运行记录，核对各动作状态；再回到对应店铺资源，确认业务结果确实符合预期。
Shopify 的手动运行功能也有不同条件，不要把它和重试失败运行混为一谈；如果事件已经发生，手动运行是否适用取决于资源类型、工作流是否启用和触发器是否匹配。Shopify Flow 手动运行说明
复核清单
- [ ] 已找到对应的运行记录，并确认失败步骤和错误信息。
- [ ] 已区分触发器未匹配、数据缺失、权限不足与运行时错误。
- [ ] 已先修复问题，而不是直接重复启用或重试。
- [ ] 已核对重试条件，以及原触发数据与当前资源状态的差异。
- [ ] 已检查新运行记录和店铺实际资源，确认动作结果符合预期。
常见问题
Shopify Flow 的错误原因在哪里查看？
进入 Apps > Flow，在 Recent runs 中找到目标记录并打开详情，查看错误步骤、状态和步骤数据。找不到记录时，先核对触发事件与筛选时间，并留意记录显示可能延迟。
提示权限不足时应该找谁？
找店铺所有者、可管理用户角色的管理员，或负责相关应用授权的管理员。提供你要执行的操作和缺少的权限项目，请对方按工作流涉及的数据、应用或密钥逐项核对。
修复后可以重试之前失败的运行吗？
可以，但要先确认原运行已结束、工作流处于启用状态且触发器仍匹配。重试会沿用原触发数据，而部分数据查询会读取最新状态；发起重试前应判断这两者的差异会不会影响业务动作。
运行很久或反复失败，先排查什么？
先看运行状态和重复报错的步骤，再检查列表循环、嵌套查询及数据范围。持续超时或限流时，优先减少不必要的数据处理；如果只是单次服务器错误，不要立即推断为工作流配置故障。
如果问题只出现在 Shopify Flow 的运行记录中，按错误步骤、数据和权限逐项处理，比更换电脑更直接。若故障实际发生在 Shopify 后台的 macOS 浏览器界面，你可以从本站的相关指南继续了解浏览器复核思路；只有确实需要复现 macOS 浏览器表现时，再考虑通过 OSXPort 租用远程 Mac。它不能替你修复 Flow 服务端故障或店铺授权问题；若你已有合适的 Mac，也可以先用现有设备验证界面，无需为此专门租用。了解远程 Mac 方案前，先明确测试需求和使用周期。
常见问题
Shopify Flow 的失败原因从哪里查？
在 Shopify 后台打开 Apps > Flow，再进入 Recent runs，按工作流、时间或错误状态筛选对应记录。打开运行详情后查看失败步骤、错误提示和该步骤使用的数据；若记录暂时未出现，先确认触发事件和筛选时间，并考虑后台日志可能有显示延迟。
Flow 提示权限不足时，应该联系谁？
向店铺所有者、可管理用户角色的管理员，或负责该应用授权的管理员申请权限。说明你无法打开的页面或执行的操作，并附上 Flow 显示的缺失权限；如果工作流涉及店铺数据、第三方应用或密钥，管理员需要按具体步骤补齐相应权限，而不是只给通用访问权。
修复工作流后，之前失败的运行能重新执行吗？
可以先按 Shopify 官方条件判断：原运行不能仍处于执行或等待状态，关联工作流需要启用，触发器也必须与原运行相匹配。手动重试会沿用原触发数据，但 Get data 动作会获取最新数据；因此重试前要确认新旧数据差异不会造成重复或错误操作。
工作流长时间运行或连续失败，应该先改什么？
先区分仍在重试、被限流、超时和已失败，再检查运行详情中反复出错的步骤。若问题集中在循环或数据查询，缩小列表范围、避免不必要的嵌套查询；若只是偶发服务器错误，先观察后续运行，不要仅凭一次报错就重写整个工作流。