自动化故障排查

从症状和涉及的版本入手。草稿检查和预览描述的是编辑器中的操作；Runs 描述的是已发布版本的执行。

Automations is in Early access. Your workspace permissions determine which actions you can perform.

仪表板中找不到 Automations

确认您已选择目标工作区，并且拥有查看 Automations 的权限。如果 Automations 未显示，请联系工作区管理员检查您的访问权限。

编辑控件缺失

Automations 读取权限允许您查看模板和工作流。创建草稿和发布需要 Automations 写入权限。如果 Use template 或 Publish 不可用，请联系工作区管理员获取写入权限。

没有出现运行记录

1. 确认自动化有已发布的版本且处于活跃状态，而非暂停或已归档。
2. 检查已发布的触发器。未保存或未发布的编辑不会影响传入事件。
3. 对于 Bird 事件，确认接收渠道已收到消息，并使用具有代表性的数据测试触发器筛选条件。
4. 对于应用事件，将其名称和必填字段与已发布的触发器进行比较，并检查请求和排队结果。
5. 对于计划任务，检查其下次执行时间、时区以及错过触发时的行为。
6. 检查是否有活跃的运行导致新的启动被跳过。
7. 检查组织的抢先体验运行配额。达到上限后，新的启动将被拒绝，直到每月重置。

筛选条件未命中或重叠跳过不会创建运行。应用程序事件被接受意味着它已进入队列；请在 Runs 中检查后续执行进度。

发布被阻止

1. 完成未关闭的字段编辑并保存草稿。
2. 打开 Checks，根据每条阻止性问题定位到对应的步骤或字段。
3. 检查必填输入、输出连接以及对缺失或后续步骤的引用。
4. 移除循环并修复无效节点，即使它们与主路径断开连接。
5. 检查权限以及任何请求的应用程序事件契约确认。

如果草稿在另一个编辑器中被修改过，请重新加载并比较当前工作，然后再重试。之前的检查结果可能已过期。

预览在操作或等待步骤处停止

检查准备好的输入。如果预览报告路径不完整，请使用 Set sample result 提供示例结果，然后重新预览。

预览无法获取联系人，也无法等待真实回执来填充缺失的示例。如果示例本身无效，请修复其节点、输出路径或字段，使其与当前配置匹配。

字段缺失或表达式执行失败

1. 选择使用该字段的步骤并检查源映射。
2. 确认源步骤在所选路径上位于当前步骤之前。
3. 检查该字段在示例或已记录的运行中是否不存在、为 null、为空或类型不同。
4. 在适当的位置添加条件或显式回退值。

未执行分支上的输出不可用。联系人搜索成功但无结果时，也需要一条显式的空结果路径。

运行持续处于等待状态

检查延迟截止时间或等待配置。确认预期的事件类型、监视的发送步骤或业务键，以及任何筛选条件。

对于应用程序事件等待，后续事件必须与现有运行的键匹配。对于回执等待，回执必须属于该运行中已配置的操作。等待是正常状态，直到匹配、超时、取消或运行截止时间将其解除。

运行成功但未收到消息

先检查运行路径：某个分支可能本就不包含发送步骤。如果发送步骤已成功执行，请检查消息的渠道状态。接受并不代表投递成功，之后仍可能出现投递失败。

使用受支持的投递等待来做后续决策。超时本身不能证明未投递，因此在发送替代消息之前请先确认。

运行在部分变更后失败

检查失败的步骤和之前已成功的步骤。联系人批量操作中可能同时包含成功和失败的条目。取消或后续失败不会回滚已接受的消息或联系人变更。

在启动新运行之前先修正原因。检查哪些操作会再次执行，以避免重复已成功完成的工作。

后续步骤

• 预览和检查工作流。
• 检查运行记录。
• 查看自动化指标。
• 浏览 Automations 指南。