Skip to main content

​
Rozwiązywanie problemów węzła

Użyj tej strony, gdy węzeł jest widoczny w statusie, ale narzędzia węzła nie działają.

​
Drabina poleceń

Następnie uruchom kontrole specyficzne dla węzła:
Zdrowe sygnały:
  • Węzeł jest połączony i sparowany dla roli node.
  • nodes describe obejmuje wywoływaną możliwość.
  • Zatwierdzenia exec pokazują oczekiwany tryb/listę dozwolonych.

​
Wymagania pierwszoplanowe

canvas.*, camera.* i screen.* są dostępne wyłącznie w trybie pierwszoplanowym na węzłach iOS/Android. Szybkie sprawdzenie i naprawa:
Jeśli zobaczysz NODE_BACKGROUND_UNAVAILABLE, przenieś aplikację węzła na pierwszy plan i spróbuj ponownie.

​
Macierz uprawnień

​
Parowanie a zatwierdzenia

To są różne bramki:
  1. Parowanie urządzenia: czy ten węzeł może połączyć się z gateway?
  2. Zatwierdzenia exec: czy ten węzeł może uruchomić konkretne polecenie powłoki?
Szybkie kontrole:
Jeśli brakuje parowania, najpierw zatwierdź urządzenie węzła. Jeśli parowanie jest poprawne, ale system.run nie działa, napraw zatwierdzenia exec/listę dozwolonych.

​
Typowe kody błędów węzła

  • NODE_BACKGROUND_UNAVAILABLE → aplikacja działa w tle; przenieś ją na pierwszy plan.
  • CAMERA_DISABLED → przełącznik kamery wyłączony w ustawieniach węzła.
  • *_PERMISSION_REQUIRED → brakujące/odrzucone uprawnienie systemowe.
  • LOCATION_DISABLED → tryb lokalizacji jest wyłączony.
  • LOCATION_PERMISSION_REQUIRED → żądany tryb lokalizacji nie został przyznany.
  • LOCATION_BACKGROUND_UNAVAILABLE → aplikacja działa w tle, ale istnieje tylko uprawnienie „Podczas użycia”.
  • SYSTEM_RUN_DENIED: approval required → żądanie exec wymaga jawnego zatwierdzenia.
  • SYSTEM_RUN_DENIED: allowlist miss → polecenie zablokowane przez tryb listy dozwolonych.

​
Szybka pętla odzyskiwania

Jeśli nadal występuje problem:
  • Ponownie zatwierdź parowanie urządzenia.
  • Ponownie otwórz aplikację węzła (pierwszy plan).
  • Ponownie nadaj uprawnienia systemowe.
  • Odtwórz/dostosuj politykę zatwierdzeń exec.
Powiązane: