AI 驅動文件
您想了解什麼？
除錯 Node-RED
本指南提供了 OV10i 相機系統上 Node-RED 問題的全面故障排除程式。可用於現場維修、除錯生產問題以及檢查流程的預防性維護。
注意
安全第一： 在對活動檢查系統進行更改之前，請始終通知生產部門。在修改流程之前建立備份。
緊急快速修復程式
關鍵系統故障 - 立即採取行動
| 步驟 | 操作 | 時間 | 結果 |
|---|---|---|---|
| 1 | 檢查相機電源 LED 狀態 | 30 秒 | 驗證硬體正常 |
| 2 | 訪問 OV10i Node-RED: http://camera-ip/recipes/<recipe-number>/ioblock | 1 分鐘 | 確認編輯器可訪問 |
| 3 | 查詢紅色三角形錯誤指示器 | 1 分鐘 | 確定故障節點 |
| 4 | 點選 部署 按鈕（完全部署） | 30 秒 | 重置所有流程 |
| 5 | 測試基本檢查觸發器 | 2 分鐘 | 驗證系統正常執行 |
系統恢復（如果編輯器無法載入）
OV10i 相機沒有安全模式 - 重啟是主要的恢復方法：
- 重啟相機（斷開電源 10 秒）
- 等待完全啟動（所有 4 個 LED 穩定 - 2-3 分鐘）
- 透過特定配方的 URL 訪問活動配方的 Node-RED
- 驗證流程完整性並進行必要的修復
- 部署更改以恢復正常操作
備註
URL 格式： http://<camera-ip>/recipes/<recipe-number>/ioblock
示例：
http://192.168.0.101/recipes/20/ioblockhttp://192.168.0.105/recipes/1/ioblock
系統除錯流程
第 1 步：識別問題範圍
快速評估問題
| 問題 | 如果是 | 如果否 |
|---|---|---|
| 您能訪問 OV10i Node-RED 介面嗎？ | 繼續第 2 步 | 檢查網路/相機狀態 |
| 流程在編輯器中可見嗎？ | 繼續第 2 步 | 重啟相機並重試 |
| 您在節點上看到錯誤三角形嗎？ | 首先關注這些節點 | 檢查流程執行 |
| 檢查是否觸發？ | 檢查單個節點輸出 | 驗證觸發輸入 |
備註
訪問 URL： 使用特定配方的 URL 格式：http://<camera-ip>/recipes/<recipe-number>/ioblock
第 2 步：啟用除錯監控
新增除錯節點以進行故障排除
- 在問題流程的關鍵點放置除錯節點：
- 在觸發輸入之後
- 在邏輯節點之前和之後
- 在最終輸出處
- 配置除錯節點以獲取最大資訊：
- 輸出： 完整的訊息物件
- 到： 除錯側邊欄
- 名稱： 描述性名稱（例如，“分類邏輯之後”）
- 透過點選編輯器中的按鈕啟用所有除錯節點
除錯側邊欄管理
訪問除錯側邊欄：
- 點選右側面板中的 除錯標籤（蟲子圖示）
- 使用垃圾桶圖示 清除舊訊息
- 如果活動節點過多，過濾訊息
除錯訊息解釋：
- 時間戳 顯示訊息發生的時間
- 節點名稱 顯示生成訊息的節點
- 訊息內容 顯示資料結構和數值
第 3 步：追蹤流程執行
跟蹤訊息路徑
- 從觸發源開始（注入、定時器、外部輸入）
- 驗證每個節點接收到預期輸入
- 檢查每一步的訊息轉換
- 識別流程停止或產生錯誤輸出的位置
常見流程中斷點
| 節點型別 | 常見問題 | 快速檢查 |
|---|---|---|
| 分類邏輯 | 未達到置信度閾值 | 檢查 ROI 對齊，重新訓練模型 |
| 開關節點 | 條件邏輯錯誤 | 驗證開關規則和訊息屬性 |
| 合併節點 | 等待不完整的訊息集 | 檢查訊息部分計數 |
| 功能節點 | JavaScript 錯誤 | 檢查瀏覽器控制檯中的錯誤 |
| HTTP 請求 | 網路連線問題 | 手動測試端點 |
常見 Node-RED 問題及解決方案
流程執行問題
問題：流程未觸發
症狀：
- 除錯側邊欄中沒有訊息
- 系統似乎處於非活動狀態
- 外部觸發器無法工作
診斷步驟：
- 檢查觸發源： 手動注入、定時器、外部輸入
- 驗證接線： 確保節點之間的連線
- 測試手動觸發： 使用注入節點強制流程開始
解決方案：
| 原因 | 解決方案 | 預防措施 |
|---|---|---|
| 禁用的流程 | 點選部署 → 完全部署 | 在更改後定期部署 |
| 斷開的連線 | 正確重新接線節點 | 編輯時進行視覺檢查 |
| 定時器配置錯誤 | 檢查注入節點的定時設定 | 記錄定時要求 |
| 外部觸發器故障 | 驗證 I/O 接線和訊號 | 定期進行 I/O 測試 |
問題：流程執行但結果錯誤
症狀：
- 訊息流動但分類不正確
- 透過/失敗邏輯未正確工作
- 結果不一致
診斷過程：
- 在可疑節點之前和之後新增除錯節點
- 比較預期與實際 訊息內容
- 檢查節點配置 以確保引數正確
解決方案：
| 問題區域 | 檢查 | 修復 |
|---|---|---|
| 分類邏輯 | ROI 對齊，模型訓練 | 重新訓練或調整 ROI |
| 開關條件 | 屬性名稱和值 | 修正開關邏輯 |
| 訊息屬性 | 資料型別和格式 | 使用更改節點修復格式 |
| 上下文變數 | 儲存值和作用域 | 清除/重置上下文儲存 |
效能問題
問題：流程執行緩慢
症狀：
- 觸發與輸出之間的延遲
- 檢查超時
- 系統滯後
效能診斷：
- 檢查除錯時間戳 以識別緩慢的節點
- 監控攝像頭系統的 CPU 使用率
- 計算活動除錯節點（禁用未使用的節點）
最佳化措施：
| 效能問題 | 解決方案 | 預期改進 |
|---|---|---|
| 除錯節點過多 | 禁用/移除未使用的除錯節點 | 10-20% 速度提升 |
| 複雜的功能節點 | 最佳化 JavaScript 程式碼 | 變數改進 |
| 高頻率觸發器 | 新增延遲/速率限制 | 防止系統過載 |
| 大型訊息物件 | 減小訊息負載大小 | 更快的處理 |
維護程式
每日健康檢查
視覺流檢查（5分鐘）
- 訪問 Node-RED 編輯器
- 檢查錯誤指示器（紅色三角形）
- 驗證流連線是否完好
- 檢視最近的除錯訊息以查詢異常
流執行測試（10分鐘）
- 使用 Inject 節點進行手動觸發測試
- 在除錯側邊欄中驗證預期輸出
- 使用已知的好/壞部件測試透過/失敗邏輯
- 確認外部通訊（PLC、資料庫）
每月維護任務
效能評估（15分鐘）
流最佳化檢查表：
| 任務 | 操作 | 備註 |
|---|---|---|
| 除錯節點清理 | 禁用未使用的除錯節點 | 僅保留必要的除錯 |
| 上下文儲存稽覈 | 清除不必要的儲存值 | 防止記憶體積累 |
| 錯誤日誌稽覈 | 檢查瀏覽器控制檯中的錯誤 | 記錄重複出現的問題 |
| 備份建立 | 匯出流到備份檔案 | 儲存日期/版本資訊 |
配置驗證（20分鐘）
- 將當前流與文件標準進行比較
- 驗證所有關鍵路徑是否具有適當的錯誤處理
- 測試錯誤恢復場景
- 更新文件以反映任何更改
每月深度維護
綜合流分析（45分鐘）
效能指標收集：
- 流執行時間
- 錯誤頻率分析
- 資源使用模式
- 通訊可靠性
流結構稽覈：
- 消除冗餘節點
- 合併重複邏輯
- 更新已棄用的配置
- 最佳化複雜的功能節點
備份和恢復測試（30分鐘）
- 建立完整的流匯出
- 在備份系統上測試匯入程式
- 驗證備份恢復是否保持功能
- 記錄恢復程式
診斷工具和技術
內建 Node-RED 工具
除錯側邊欄功能
| 功能 | 用例 | 訪問方法 |
|---|---|---|
| 訊息過濾 | 專注於特定節點 | 側邊欄中的過濾按鈕 |
| 訊息歷史 | 檢視過去的 100 條訊息 | 在除錯側邊欄中滾動 |
| 節點位置 | 查詢除錯訊息的來源 | 點選訊息中的節點名稱 |
| 訊息匯出 | 儲存診斷資料 | 複製訊息內容 |
上下文資料瀏覽器
訪問上下文儲存：
- 開啟 OV10i Node-RED 介面（
http://<camera-ip>/recipes/<recipe-number>/ioblock） - 轉到上下文資料選項卡（右側邊欄）
- 檢視節點/流/全域性上下文值
上下文除錯：
- 節點上下文： 檢查單個節點狀態
- 流上下文： 驗證共享流變數
- 全域性上下文： 審查系統範圍的設定
網路通訊測試
HTTP 請求驗證：
- 使用外部工具（Postman、curl）測試端點
- 驗證響應格式是否與預期資料匹配
- 測試錯誤條件（超時、無效響應）
PLC 通訊驗證：
- 使用 PLC 程式設計軟體驗證連線性
- 獨立測試資料暫存器訪問
- 驗證資料格式轉換
緊急恢復程式
流程損壞恢復
損壞的症狀：
- OV10i Node-RED 介面無法載入流程
- 相機重啟後流程顯示為空
- 部署重複失敗
恢復步驟：
- 對 OV10i 相機進行斷電重啟：
- 拔掉電源 10 秒
- 等待完全啟動（所有 4 個 LED 穩定）
- 訪問配方的 Node-RED 介面：
- 導航到
http://<camera-ip>/recipes/<recipe-number>/ioblock - 如果流程損壞，從備份匯入
- 導航到
- 從備份恢復：
- 使用 OV10i 配方匯入功能
- 匯入最近的備份檔案
- 驗證所有連線完好
- 驗證恢復：
- 測試所有關鍵流程
- 驗證外部通訊
- 更新任何配置更改
系統資源問題
記憶體/CPU 超載
立即採取的措施：
- 在 OV10i Node-RED 中禁用非必要的除錯節點
- 移除高頻率定時觸發器
- 簡化複雜的功能節點
- 對相機進行斷電重啟以重啟所有服務
長期解決方案：
- 最佳化 OV10i 硬體的流程設計
- 實施速率限制
- 減少訊息負載大小
- 安排維護視窗
故障排除檢查表
維護前檢查表
- 通知生產維護視窗
- 建立當前流程備份
- 記錄當前系統狀態
- 準備回滾程式
- 測試備份恢復過程
維護後驗證
- 所有流程成功部署
- 手動觸發測試透過
- 外部通訊已驗證
- 錯誤指示燈已清除
- 效能在可接受範圍內
- 文件已更新
緊急響應檢查表
- 評估系統影響
- 通知生產
- 嘗試快速修復
- 如有必要進行備份恢復
- 確定根本原因
- 實施預防措施
文件和日誌記錄
維護記錄
所需文件：
- 維護日期/時間
- 識別和解決的問題
- 進行的配置更改
- 實現的效能改進
- 未來建議
🔗 參見
提示
記錄在除錯會話中所做的所有更改。這有助於未來的故障排除，併為您的團隊建立知識積累。