调试低代码应用

低代码应用的调试台用于检查用户界面组件事件的真实执行过程。你可以在搭建页面时触发按钮、输入框等组件的事件，并在时间线中查看触发组件、事件类型、执行动作、状态、耗时、输入参数、调用结果和失败原因。

调试台关注的是页面交互的运行结果。工作流或对话流自身的节点逻辑，应先在对应的业务逻辑编辑器中完成试运行，再回到用户界面检查组件绑定与参数传递。

进入调试台

1. 打开需要调试的低代码应用。
2. 在页面顶部选择 用户界面。
3. 在画布下方工具栏单击扳手形状的调试工具图标。
4. 页面底部展开时间线面板。

时间线初次打开时显示“暂无时间线记录”。进入预览状态并触发组件事件后，记录会实时追加到这里。

调试前检查

为了让时间线记录能够反映真实问题，建议先完成以下准备：

1. 确认目标组件已配置事件，例如按钮的点击时事件。
2. 确认事件动作已选择工作流、对话流、页面跳转或变量操作。
3. 核对动作要求的必填输入是否已经绑定到组件值、页面变量或应用变量。
4. 单击右侧属性面板顶部的预览，使画布进入可交互状态。
5. 保持时间线面板展开，再执行一次完整操作。

TIP

调试前不要只看组件是否已经出现在画布上。组件有事件配置，不代表输入映射、资源引用和结果处理一定正确，最终应以时间线中的实际运行结果为准。

查看失败结果

下面的示例中，按钮的点击时事件已经绑定工作流，但触发时没有传入工作流要求的 query 参数，因此时间线生成失败记录。

单击失败记录后，右侧详情会显示：

信息	用途
组件与事件	确认是哪一个组件、哪一种事件触发了动作
动作与资源	确认实际调用的工作流、对话流或其他动作
状态与耗时	判断是立即校验失败、执行超时，还是运行中断
失败信息	查看平台返回的具体原因，例如必填参数缺失
错误码	用于进一步定位运行时错误类型
输入	核对组件事件实际传入的结构化数据

本例失败信息为 ENTRY_INPUT_INVALID: "query" is a required property，输入详情中的 query 为 undefined。这说明问题在组件事件的输入映射，而不是按钮没有触发，也不是工作流入口不存在。

修正后验证成功结果

补齐必填参数后再次触发同一个按钮，时间线新增一条成功记录。展开记录可以同时核对输入值与工作流调用结果。

成功记录至少应检查以下内容：

1. 状态是否为成功，耗时是否处于可接受范围。
2. 输入参数是否等于页面上实际填写或选择的值。
3. 调用的资源名称是否与组件事件配置一致。
4. 调用结果中是否包含页面后续展示或跳转需要的字段。
5. 页面上的结果组件是否已经按预期更新。

如果时间线显示成功，但页面没有更新，应继续检查事件的结果处理、变量赋值和组件内容绑定，而不是重复运行工作流。

筛选和清理时间线

时间线右上角提供状态筛选，可以选择：

• 全部：查看本次调试产生的所有事件。
• 成功：只看已完成且执行成功的事件。
• 错误：只看校验失败或运行失败的事件。
• 加载中：只看仍在执行的事件。

每条记录旁的删除按钮用于移除单条记录；顶部清理按钮用于清空当前时间线。

WARNING

清空后的时间线记录不能恢复。需要保留错误信息、输入输出或耗时证据时，应先截图或复制结构化数据。

属性配置错误

旧版调试台曾将组件属性错误集中显示在独立的“错误”页签中。当前版本的底部调试面板以时间线为主；组件内容表达式或属性配置不合法时，画布和右侧属性面板会直接显示错误提示。

发现组件显示“请检查配置”或内容无法渲染时，按以下顺序处理：

1. 在画布中选中报错组件。
2. 打开右侧属性，检查带错误提示的内容、可见性、禁用条件和数据源配置。
3. 如果属性引用了变量，确认变量路径、数据类型和默认值均有效。
4. 修正后观察画布错误是否自动消失。
5. 再进入预览并触发事件，通过时间线验证交互结果。

常见问题定位

现象	优先检查
单击组件后没有时间线记录	是否已进入预览、组件是否配置对应事件、底部面板是否展开
立即失败且耗时很短	必填输入、字段类型、资源是否存在、事件参数映射
长时间显示加载中	工作流运行状态、超时节点、外部服务和失败分支
时间线成功但页面无变化	结果处理、变量赋值、组件内容绑定和页面跳转动作
输入值为 undefined	表单字段路径、组件值变量或事件输入表达式
画布直接显示配置错误	选中组件，检查右侧属性表达式和引用变量

推荐调试顺序

1. 在业务逻辑编辑器中独立试运行工作流或对话流。
2. 在用户界面中检查组件事件和输入映射。
3. 打开时间线，先制造一次可解释的失败，确认错误定位有效。
4. 修正配置后再次运行，核对成功记录的输入与结果。
5. 最后测试空输入、重复单击、失败分支和长耗时场景。