跳到主要内容

Node-RED 调试

本指南提供 OV20i 摄像头系统上 Node-RED 问题的全面故障排除流程。可用于现场检修、排查生产问题以及对检测流程的预防性维护。

注意

Safety First: 在对正在运行的检测系统进行修改前，请始终通知生产并在修改流程前进行备份。

紧急快速修复程序​

系统关键故障 - 立刻行动​

步骤操作时长结果
1检查相机电源 LED 状态30 秒确认硬件正常
2访问 OV20i Node-RED：http://camera-ip/recipes/<recipe-number>/ioblock1 分钟编辑器可访问性确认
3查找红色三角形错误指示标志1 分钟标识出故障节点
4点击 Deploy 按钮（Full Deploy）30 秒重置所有流程
5测试基本检测触发2 分钟验证系统是否运行正常

系统恢复（如果 Editor Won't Load）​

OV20i 摄像头没有安全模式——重启是主要的恢复方法：

  1. 断电并重新上电摄像头（断开电源 10 秒）
  2. 等待完整启动（全部 4 个 LEDs 固定亮起 - 约 2-3 分钟）
  3. 通过配方特定的 URL 访问活动配方的 Node-RED
  4. 验证流程完整性并进行必要的修复
  5. 部署变更以恢复正常运行
备注

URL 格式： http://<camera-ip>/recipes/<recipe-number>/ioblock

示例：

  • http://192.168.0.101/recipes/20/ioblock
  • http://192.168.0.105/recipes/1/ioblock

系统化调试流程​

第 1 步：确定问题范围​

快速评估问题​

问题若为 Yes（是）若为 No（否）
是否可以访问 OV20i 的 Node-RED 界面？进入第 2 步检查网络/相机状态
编辑器中是否能看到流程？进入第 2 步断电重启相机并重试
是否在节点上看到错误三角形？优先关注这些节点检查流程执行情况
检测是否正在触发？检查各节点输出验证触发输入
备注

访问 URL： 使用配方特定的 URL 格式：http://<camera-ip>/recipes/<recipe-number>/ioblock

第 2 步：启用调试监控​

为故障排除添加调试节点​

  1. 在问题流程的关键点放置 Debug 节点：
    • 触发输入之后
    • 逻辑节点的前后
    • 最终输出处
  2. 为尽可能获取完整信息而配置 Debug 节点：
    • 输出（Output）： 完整的消息对象
    • 到（To）： Debug 侧边栏
    • 名称（Name）： 描述性名称（如 “After Classification Logic”）
  3. 在编辑器中点击按钮启用所有 Debug 节点

调试侧边栏管理​

访问调试侧边栏：

  • 在右侧面板点击 Debug 选项卡（错误图标）
  • 使用垃圾桶图标清除旧消息
  • 如节点数量过多，请使用筛选消息

调试消息解释：

  • 时间戳（Timestamp） 显示消息发生时间
  • 节点名称（Node name） 显示生成该消息的节点
  • 消息内容（Message content） 显示数据结构和值

第 3 步：跟踪流程执行​

跟踪消息路径​

  1. 从触发源开始（注入、定时器、外部输入）
  2. 验证每个节点接收到了预期输入
  3. 检查每一步中的消息转换
  4. 识别流程在何处停止或产生错误输出

常见流程中断点​

节点类型常见问题快速检查
分类逻辑未达到置信度阈值检查 ROI 对齐，重新训练模型
Switch 节点条件逻辑错误验证开关规则和消息属性
Join 节点等待不完整的消息集检查消息部分数量
Function 节点JavaScript 错误检查浏览器控制台中的错误
HTTP 请求网络连接手动测试端点

常见 Node-RED 问题与解决方案​

流程执行问题​

问题：流程未触发​

症状：

  • 调试侧边栏中无消息
  • 系统看起来处于非活动状态
  • 外部触发不起作用

诊断步骤：

  1. 检查触发源： 手动注入、定时器、外部输入
  2. 验证连线： 确保节点之间的连接
  3. 测试手动触发： 使用 Inject 节点强制启动流程

解决方案：

原因解决方案防止措施
禁用的流程点击 Deploy → 完全部署变更后定期部署
连接断开正确重新连线节点编辑过程中的可视化检查
定时器配置错误检查 Inject 节点的定时设置记录定时要求
外部触发失败验证 I/O 布线与信号定期进行 I/O 测试

问题：流程正在运行但结果错误​

症状：

  • 消息在流动但分类结果不正确
  • 通过/失败逻辑未正确工作
  • 结果不一致

诊断过程：

  1. 在可疑节点前后添加 Debug 节点
  2. 比较期望与实际的消息内容
  3. 检查节点配置以确保参数正确

解决方案：

问题区域检查项修复措施
分类逻辑ROI 对齐，模型训练重新训练或调整 ROI
Switch 条件属性名称和值修正开关逻辑
消息属性数据类型和格式使用 Change 节点修正格式
上下文变量存储的值与作用域清除/重置上下文存储

性能问题​

问题：流程执行缓慢​

症状：

  • 触发与输出之间的延迟
  • 检查超时
  • 系统滞后

性能诊断：

  1. 检查 Debug 时间戳以识别慢节点
  2. 监控摄像头系统的 CPU 使用率
  3. 统计活动 Debug 节点（禁用/移除未使用的节点）

优化措施：

性能问题解决方案预期改进
调试节点过多禁用/移除未使用的 Debug 节点提升约 10-20% 的速度
复杂的 Function 节点优化 JavaScript 代码变量改进（视具体情况而定）
高频触发添加延时/速率限制防止系统过载
大型消息对象减少消息载荷大小处理更快

维护程序​

每日健康检查​

视觉流程检查（5 分钟）​

  1. 访问 Node-RED 编辑器
  2. 检查错误指示符（红色三角形）
  3. 验证流程连接是否完好
  4. 查看最近的 Debug 消息以发现异常

流程执行测试（10 分钟）​

  1. 使用 Inject 节点进行手动触发测试
  2. 在 Debug 侧边栏中验证预期输出
  3. 使用已知良品与不良品测试通过/失败逻辑
  4. 确认外部通信（PLC、数据库）

月度维护任务​

性能评估（15 分钟）​

流程优化清单：

任务措施说明
调试节点清理禁用未使用的调试节点仅保留必要的调试输出
上下文存储审查清除不必要的存储值防止内存堆积
错误日志审查检查浏览器控制台中的错误记录重复出现的问题
备份创建导出流程到备份文件按日期/版本信息存档

配置验证（20 分钟）​

  1. 将当前流程与文档化标准进行比较
  2. 验证所有关键路径是否具备适当的错误处理
  3. 测试错误恢复场景
  4. 对任何变更更新文档

月度深度维护​

综合流程分析（45 分钟）​

性能指标采集：

  • 流程执行时间
  • 错误发生频率分析
  • 资源使用模式
  • 通信可靠性

流程结构回顾：

  • 消除冗余节点
  • 整合重复逻辑
  • 更新已弃用的配置
  • 优化复杂的 Function 节点

备份与恢复测试（30 分钟）​

  1. 创建完整的流程导出
  2. 在备份系统上测试导入过程
  3. 验证备份还原是否保持功能
  4. 记录恢复程序

诊断工具与技术​

内置 Node-RED 工具​

调试侧边栏功能​

功能使用场景访问方式
消息过滤聚焦特定节点侧边栏中的筛选按钮
消息历史回顾最近 100 条消息在 Debug 侧边栏滚动查看
节点定位查找 Debug 消息来源在消息中单击节点名称
消息导出保存诊断数据复制消息内容

上下文数据查看器​

访问上下文存储：

  • 打开 OV20i Node-RED 界面（http://<camera-ip>/recipes/<recipe-number>/ioblock）
  • 转到右侧边栏的 Context Data 选项卡
  • 查看 Node/Flow/Global 上下文值

上下文调试：

  • 节点上下文： 检查单个节点状态
  • 流程上下文： 验证共享流程变量
  • 全局上下文： 查看系统范围设置

网络通信测试​

HTTP 请求验证：

  1. 使用外部工具（Postman、curl）测试端点
  2. 验证响应格式是否与预期数据匹配
  3. 测试错误条件（超时、无效响应）

PLC 通信验证：

  1. 使用 PLC 编程软件验证连通性
  2. 独立测试数据寄存器访问
  3. 验证数据格式转换

紧急恢复程序​

流程损坏恢复​

损坏症状：​

  • OV20i Node-RED 界面无法加载流程
  • 摄像头重启后，流程显示为空
  • 部署反复失败

恢复步骤：​

  1. 对 OV20i 摄像头进行电源循环（Power cycle）:
    • 断开电源 10 秒
    • 等待完成启动（所有 4 个 LED 指示灯稳定）
  2. 访问配方的 Node-RED 界面：
    • 导航至 http://<camera-ip>/recipes/<recipe-number>/ioblock
    • 如果流程损坏，请从备份导入
  3. 从备份恢复：
    • 使用 OV20i 的配方导入功能
    • 导入最近的备份文件
    • 验证所有连接是否完好
  4. 验证恢复结果：
    • 测试所有关键流程
    • 验证外部通信
    • 更新任何配置变更

系统资源问题​

内存/CPU 过载​

即时措施：

  1. 在 OV20i Node-RED 中禁用非必需的 Debug 节点
  2. 移除高频率定时器触发
  3. 简化复杂的 Function 节点
  4. 对摄像头进行电源循环（Power cycle）以重启所有服务

长期解决方案：

  • 为 OV20i 硬件优化流程设计
  • 实施速率限制
  • 减少消息载荷大小
  • 计划维护窗口

故障排除清单​

维护前清单​

  • 通知生产线维护窗口
  • 创建当前流程备份
  • 记录当前系统状态
  • 准备回滚过程
  • 测试备份恢复过程

维护后验证​

  • 所有流程成功部署
  • 手动触发测试通过
  • 外部通信已验证
  • 错误指示已清除
  • 性能处于可接受范围内
  • 文档已更新

紧急响应清单​

  • 系统影响已评估
  • 已通知生产线
  • 已尝试快速修复
  • 如有需要，进行备份还原
  • 已识别根本原因
  • 已实施预防措施

文档与日志​

维护记录​

所需文档：

  • 维护日期/时间
  • 已识别并解决的问题
  • 已进行的配置变更
  • 实现的性能改进
  • 未来建议

🔗 参见下文​

提示

在调试会话中记录所有变更。此做法有助于将来排查故障并为您的团队积累知识。