ノードのトラブルシューティング
ステータス上でノードは表示されているが、ノードツールが失敗する場合は、このページを使用してください。コマンドラダー
- ノードが接続され、役割
nodeに対してペアリングされています。 nodes describeに、呼び出している機能が含まれています。- 実行承認に、期待されるモード / 許可リストが表示されています。
フォアグラウンド要件
canvas.*、camera.*、screen.* は、iOS/Android ノードではフォアグラウンド専用です。
簡易チェックと修正:
NODE_BACKGROUND_UNAVAILABLE が表示される場合は、ノードアプリをフォアグラウンドにして再試行してください。
権限マトリクス
ペアリングと承認の違い
これらは異なるゲートです。- デバイスのペアリング: このノードはゲートウェイに接続できますか。
- 実行承認: このノードは特定のシェルコマンドを実行できますか。
system.run が失敗した場合、 exec approvals/allowlist を修正します。
一般的なノードのエラーコード
NODE_BACKGROUND_UNAVAILABLE→ アプリがバックグラウンドです。フォアグラウンドにしてください。CAMERA_DISABLED→ ノード設定でカメラのトグルが無効です。*_PERMISSION_REQUIRED→ OS の権限が不足または拒否されています。LOCATION_DISABLED→ 位置情報モードがオフです。LOCATION_PERMISSION_REQUIRED→ 要求された位置情報モードが付与されていません。LOCATION_BACKGROUND_UNAVAILABLE→ アプリがバックグラウンドですが、「使用中のみ」の権限しかありません。SYSTEM_RUN_DENIED: approval required→ 実行リクエストに明示的な承認が必要です。SYSTEM_RUN_DENIED: allowlist miss→ コマンドが許可リストモードによりブロックされています。
迅速な復旧ループ
- デバイスのペアリングを再承認します。
- ノードアプリを再度開きます（フォアグラウンド）。
- OS の権限を再付与します。
- 実行承認ポリシーを再作成 / 調整します。