Khắc phục sự cố Node
Sử dụng trang này khi một node hiển thị trong trạng thái nhưng công cụ node không hoạt động.
Thứ tự lệnh
Sau đó chạy các kiểm tra cụ thể cho node:
Dấu hiệu hoạt động tốt:
- Node đã kết nối và ghép nối cho vai trò
node.
nodes describe bao gồm khả năng bạn đang gọi.- Phê duyệt exec hiển thị chế độ/danh sách cho phép mong đợi.
Yêu cầu foreground
canvas.*, camera.*, và screen.* chỉ hoạt động foreground trên các node iOS/Android.
Kiểm tra và khắc phục nhanh:
Nếu thấy NODE_BACKGROUND_UNAVAILABLE, đưa ứng dụng node lên foreground và thử lại.
Ma trận quyền truy cập
Ghép nối và phê duyệt
Đây là các cổng khác nhau:
- Ghép nối thiết bị: node này có thể kết nối với gateway không?
- Phê duyệt exec: node này có thể chạy một lệnh shell cụ thể không?
Kiểm tra nhanh:
Nếu thiếu ghép nối, phê duyệt thiết bị node trước.
Nếu ghép nối ổn nhưng system.run thất bại, sửa phê duyệt exec/danh sách cho phép.
Mã lỗi thường gặp của node
NODE_BACKGROUND_UNAVAILABLE → ứng dụng đang ở chế độ nền; đưa lên foreground.CAMERA_DISABLED → camera bị tắt trong cài đặt node.*_PERMISSION_REQUIRED → thiếu/quyền OS bị từ chối.LOCATION_DISABLED → chế độ vị trí tắt.LOCATION_PERMISSION_REQUIRED → chế độ vị trí yêu cầu không được cấp.LOCATION_BACKGROUND_UNAVAILABLE → ứng dụng ở chế độ nền nhưng chỉ có quyền Khi Sử Dụng.SYSTEM_RUN_DENIED: approval required → yêu cầu exec cần phê duyệt rõ ràng.SYSTEM_RUN_DENIED: allowlist miss → lệnh bị chặn bởi chế độ danh sách cho phép.
Trên các host node Windows, các dạng shell-wrapper như cmd.exe /c ... được coi là thiếu danh sách cho phép trong
chế độ danh sách cho phép trừ khi được phê duyệt qua luồng hỏi.
Vòng lặp khôi phục nhanh
Nếu vẫn gặp sự cố:
- Phê duyệt lại ghép nối thiết bị.
- Mở lại ứng dụng node (foreground).
- Cấp lại quyền OS.
- Tạo lại/điều chỉnh chính sách phê duyệt exec.
Liên quan:
Lần sửa đổi cuối 22 tháng 3, 2026
