---
title: "自动化故障排查"
description: "查找自动化未启动、预览停止、字段不可用，或运行处于等待、失败、完成但未投递消息的原因。"
canonical: "https://bird.com/zh-sg/wendang/guides/automations/troubleshooting"
---

# 自动化故障排查

从症状和涉及的版本入手。草稿检查和预览描述的是编辑器中的操作；**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. 对于应用事件，将其名称和必填字段与已发布的触发器进行比较，并[检查请求和排队结果](/docs/guides/automations/application-events#troubleshoot-an-event)。
5. 对于计划任务，检查其下次执行时间、时区以及错过触发时的行为。
6. 检查是否有活跃的运行导致新的启动被跳过。
7. 检查组织的[抢先体验运行配额](/docs/guides/automations/runs#early-access-run-allowance)。达到上限后，新的启动将被拒绝，直到每月重置。

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

## 发布被阻止

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

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

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

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

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

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

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

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

## 运行持续处于等待状态

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

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

## 运行成功但未收到消息

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

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

## 运行在部分变更后失败

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

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

## 后续步骤

- [预览和检查工作流](/docs/guides/automations/preview)。
- [检查运行记录](/docs/guides/automations/runs)。
- [查看自动化指标](/docs/guides/automations/metrics)。
- [浏览 Automations 指南](/docs/guides/automations)。

## Related resources

- [Preview your first automation](/docs/get-started/automations) (docs)