Appearance
常见问题与故障排查
排查 RPA Plus 问题时，先确认失败发生在流程校验、编辑器调试、正式任务调度还是具体节点执行阶段。优先处理日志中的第一个错误，后续问题可能只是前置步骤失败带来的结果。
快速检查
| 现象 | 优先检查 |
|---|---|
| 保存或调试前节点标红 | 必填字段、变量名、IF 分支和循环回扣。 |
| 调试环境不可选 | 内核版本是否不低于 118，平台是否支持。 |
| 找不到页面元素 | 当前标签页、页面加载状态、选择器和元素序号。 |
| 变量无法选择或没有值 | 变量来源、上下游连线、分支和从节点调试范围。 |
| 本地文件操作失败 | 路径、文件权限、执行电脑和客户端状态。 |
| 定时任务未执行 | 任务启用状态、时间、本地客户端和调度服务。 |
| 找不到历史日志 | 是否为调试日志、是否更换电脑或删除了任务。 |
流程无法保存或调试
节点配置错误
打开自动聚焦的节点，检查必填字段、输出变量名和 JSON 内容。
常见原因：
- URL、选择器或输出变量为空。
- 变量名不是合法 JavaScript 标识符。
- 同一变量编辑列表中出现重名。
- 数组或对象不是合法 JSON。
- JavaScript 脚本语法不正确。
修复第一个错误后重新保存，编辑器会继续检查剩余问题。
IF 或循环结构错误
检查：
- IF 是否同时连接
True和False。 - 循环的
Loop Start是否进入循环体。 - 循环体是否至少有一条边返回
Loop End。 - 普通节点是否存在不属于 IF 合法汇合的多个入口。
- 关闭环境是否连接了普通出口。
详细连线示例见流程控制节点。
节点没有执行
节点必须从开始流程出发沿连线可达。检查节点是否只是放在画布上但没有接入主路径，或连线方向是否接反。
调试环境问题
环境不可选择
调试环境的浏览器内核必须不低于 118，并且该版本需要受当前操作系统平台支持。不符合条件的环境不能用于调试。
没有可用环境时，使用有权限的账号创建兼容环境，或改用已有兼容环境。
| 图示状态 | 原因 | 处理方式 |
|---|---|---|
| 绿色框 | 内核和平台均满足调试要求。 | 选择该环境开始调试。 |
| 红色框：内核过低 | 浏览器内核版本低于 118。 | 改用内核不低于 118 的环境。 |
| 红色框：平台不支持 | 当前平台不支持该内核版本。 | 选择当前平台支持的环境版本。 |
环境已经运行，是否必须关闭
不必把关闭环境作为固定前置条件。当前实现会优先尝试复用已运行环境的连接，无法复用时再准备新的运行环境。
复用失败时，可以重新选择环境，并检查桌面客户端和本地服务是否正常。
点击停止后仍显示运行
停止按钮会向本地执行器发送请求，最终状态需要等待执行器回推。不要连续点击停止。长时间无变化时，检查本地服务和调试日志。
页面元素问题
找不到元素
按顺序检查：
- 确认当前标签页是否正确。
- 等待页面完成跳转或加载。
- 检查 Selector、XPath 或文字是否仍能匹配。
- 检查目标元素是否可见，以及固定序号或随机区间是否超过匹配数量。
- 必要时在操作前添加 等待元素出现。
匹配到错误元素
页面存在多个相同元素时，缩小定位范围并明确元素序号。优先使用稳定 id、name 或 data-* 属性，避免随机类名和过长绝对 XPath。
保存的元素对象不能使用
确认变量类型为 element，并且使用节点位于输出节点下游。页面刷新、跳转或 DOM 更新后，之前保存的元素对象可能失效，应重新获取。
变量和数据问题
当前节点看不到变量
流程变量只会从产生它的节点开始提供给下游。检查：
- 输出变量名是否已经填写并通过校验。
- 当前节点是否位于输出节点下游。
- 变量是否产生在另一条不相交分支。
- 当前节点是否位于分组内正确顺序。
系统变量是独立的全局清单，不受普通流程变量回溯限制。
从中间节点调试时变量为空
从节点调试不会执行该节点之前的普通节点，因此这些节点的输出不会产生。开始节点中的全局变量仍然可用。
改为从更早节点调试，或把测试所需的固定输入临时准备为开始节点变量。
数组或对象格式错误
使用合法 JSON：英文括号、英文双引号、英文逗号和冒号，最后一项后不加逗号。
json
{"name":"demo","items":[1,2,3]}JSON 解析或字段提取失败
先检查上游变量实际内容。JSON 文本不能夹带额外说明；字段提取要核对对象键大小写和数组结构。
Excel 和本地文件问题
Excel 表头校验失败
首行表头必须能够转换为合法且不重复的变量名。建议使用小写英文和下划线，并删除空白或重复表头。
动态 Excel 路径没有提前生成变量
只有静态本地路径会在设计阶段读取表头。变量路径需要等到运行时解析，不会在编辑阶段提前读取动态文件。
某个环境没有 Excel 数据
按环境序号读取时，检查 serial_number 是否有对应数据行。可以根据业务需要开启“环境序号没有对应行时跳过”。
保存后找不到文件
存到文件和存到 Excel 使用系统默认下载目录，执行器分别补充 .txt 和 .xlsx 扩展名。打开运行日志检查完整路径；路径和文件名齐全时，可以从日志定位文件。
迁移流程后文件节点失败
本地文件和目录不会随流程画布自动迁移。在新电脑上重新选择 Excel、txt、附件和输出目录，并确认客户端具有读写权限。
导入、导出和分享问题
导入失败且画布没有变化
这是校验失败时的保护行为。根据提示检查 JSON、节点字段、开始节点和图结构，失败的导入不会修改当前流程或列表。
编辑器导入后列表仍是旧流程
编辑器导入只替换当前画布，必须手动保存才会更新已存流程。
导入后流程设置不同
导出的 JSON 只包含节点和连线，不包含流程名称、备注和流程设置。导入后需要重新核对流程设置。
分享码无法识别
有效分享码长度为 8-64 位，只允许字母、数字、下划线和短横线。可以粘贴纯分享码，也可以粘贴完整分享文案或携带分享码的 URL。
格式正确仍无法获取时，分享可能已经过期、达到兑换次数或被删除。
任务调度问题
立即任务保存后自动启动
这是新建立刻任务的预期行为。保存前应确认流程、环境、并发和超时配置。
任务无法提交
检查：
- 关联流程是否仍然存在。
- 是否至少绑定一个环境。
- 环境并发是否不超过环境数量。
- 单环境超时是否为非负值。
- 定时或重复任务开始时间是否在未来。
- 重复任务是否填写有效结束时间。
定时或重复任务没有执行
确认任务处于启用状态，开始和结束时间有效，并且中屹浏览器桌面客户端及本地调度服务在触发时间正常运行。
无法删除任务
运行中且启用的任务不能删除。先停止任务，等待状态更新后再操作。
调高并发后仍没有同时运行
任务环境并发不能超过绑定环境数，并且还受到设备级全局并发限制。RPA Plus 与旧版 RPA 共用本地设备并发设置。
运行记录问题
调试记录没有出现在运行记录中
运行记录只显示正式任务记录。编辑器调试日志在流程编辑器的调试日志抽屉中查看。
更换电脑后看不到历史记录
运行摘要和明细保存在执行电脑的本地 IndexedDB 中，不会作为纯服务端记录自动出现在另一台电脑。
删除任务后日志消失
删除任务会同时清理该任务的本地运行记录。删除前先完成所需排查和记录。
记录一直显示运行中
先检查：
- 在运行记录中找到状态为异常的任务和环境。
- 打开详情，进入对应的结构化运行日志。
- 定位第一条异常消息，先处理它，再判断后续错误是否仍然存在。
仍未定位问题时
整理以下信息后再继续排查：
- 中屹浏览器客户端版本和操作系统。
- 浏览器环境内核版本。
- 流程中第一个失败节点的名称和配置类型。
- 调试或正式任务日志中的第一条异常。
- 问题是否只发生在特定环境、电脑或任务类型。
- 是否涉及本地路径、权限、代理或页面改版。
- 重启软件查看是否解决。
- 联系客服。
分享排查材料前删除账号密码、Cookie、身份验证器密钥、分享码和业务敏感内容。