Encja niedostępna (unavailable) w Home Assistant – jak znaleźć przyczynę

Stan unavailable nie mówi jeszcze, co się zepsuło. Informuje tylko, że istniejąca encja nie może obecnie dostarczyć danych. Przyczyną może być samo urządzenie, sieć, usługa producenta, broker MQTT, integracja albo encja źródłowa.

Najskuteczniejsza diagnostyka zaczyna się od ustalenia zakresu problemu i sprawdzania jednej warstwy naraz. Ten poradnik prowadzi przez ten proces bez usuwania konfiguracji i restartowania wszystkiego w ciemno.

unavailable oznacza, że encja istnieje w Home Assistant, ale system nie może jej obecnie osiągnąć lub otrzymać od niej danych. Urządzenie może być wyłączone, integracja mogła nie załadować się poprawnie albo komunikacja została przerwana.

unknown oznacza inny stan: encja istnieje, lecz Home Assistant nie zna teraz jej wartości. Może na przykład czekać na pierwszy odczyt. Brak encji, nieznana wartość i niedostępna komunikacja nie powinny być traktowane jako ten sam problem.

Encja, urządzenie i integracja

Encja jest pojedynczym punktem danych lub sterowania, np. temperaturą albo przełącznikiem. Urządzenie grupuje encje należące do jednego sprzętu. Integracja jest warstwą komunikacji łączącą Home Assistant z urządzeniem lub usługą. Jedno urządzenie może więc działać częściowo, mimo że jedna z jego encji jest niedostępna.

• Jedna encja: sprawdź, czy nie została wyłączona, usunięta przez urządzenie albo zależy od osobnego źródła.
• Wszystkie encje urządzenia: podejrzewaj zasilanie, połączenie urządzenia lub jego wpis w integracji.
• Wszystkie urządzenia integracji: sprawdź konfigurację, uwierzytelnienie, broker, koordynator albo usługę producenta.
• Wiele niezależnych urządzeń: sprawdź sieć, router, DNS, VLAN, zasilanie infrastruktury i stan Home Assistant.

Zapisz też moment wystąpienia problemu: po restarcie, aktualizacji, zmianie sieci, zmianie hasła czy zaniku zasilania. Ta informacja często zawęża przyczynę szybciej niż kolejny restart.

1. Otwórz szczegóły encji i przejdź do powiązanego urządzenia. Zapisz nazwę integracji oraz identyfikator encji.
2. Przejdź do Ustawienia → Urządzenia i usługi. Otwórz właściwą integrację i sprawdź, czy zgłasza błąd konfiguracji lub połączenia.
3. Sprawdź Ustawienia → System → Naprawy. Home Assistant umieszcza tam wykryte problemy wymagające działania użytkownika.
4. W Ustawienia → System → Logi wyszukaj nazwę integracji, urządzenia lub identyfikator encji. Skup się na wpisach z czasu wystąpienia problemu.
5. Jeżeli integracja prosi o ponowne uwierzytelnienie, wykonaj tę procedurę bez usuwania całej integracji.
6. Jeśli integracja udostępnia przeładowanie i błąd dotyczy wyłącznie jej, przeładuj właśnie ją. Najpierw zachowaj potrzebne informacje z logu.
7. Restart Home Assistant ma sens po aktualizacji, zmianie konfiguracji wymagającej ponownego uruchomienia albo gdy integracja utknęła. Powtarzany bez sprawdzenia logów może tylko usunąć ślady i opóźnić rozpoznanie przyczyny.

Szersze wyjaśnienie, jak urządzenia łączą się z systemem, znajdziesz w poradniku Integracje Home Assistant.

Najpierw potwierdź zasilanie urządzenia i sprawdź w routerze, czy nadal jest połączone. Jeżeli integracja używa adresu IP, porównaj go z aktualnym adresem urządzenia. Rezerwacja DHCP w routerze ogranicza ryzyko, że adres zmieni się po restarcie.

Sprawdź dostępność urządzenia z tej samej sieci i jego aplikację lub lokalny interfejs, jeśli taki posiada. Jeżeli urządzenie działa, a Home Assistant go nie osiąga, sprawdź reguły VLAN, firewall, DNS, izolację klientów Wi-Fi i blokowanie ruchu lokalnego. To rozróżnia awarię sprzętu od problemu na drodze komunikacji.

Nie zakładaj automatycznie, że odpowiedź na ping dowodzi pełnej sprawności integracji: właściwy port lub protokół może nadal być blokowany.

Sprawdź internet po stronie Home Assistant i czy usługa producenta nie ma awarii. Jeżeli oficjalna aplikacja również nie pobiera danych, problem prawdopodobnie znajduje się poza Home Assistant.

Typowe przyczyny to wygasła sesja lub token, zmiana hasła, nowe wymaganie logowania, limit API albo błąd serwera. Gdy Home Assistant pokaże prośbę o ponowne uwierzytelnienie, użyj jej. Nie usuwaj całej integracji tylko po to, aby zalogować się ponownie; mogłoby to zmienić identyfikatory i zależności.

Sprawdź oddzielnie połączenie Home Assistant z brokerem oraz połączenie urządzenia z brokerem. Działająca integracja MQTT nie dowodzi jeszcze, że konkretne urządzenie publikuje wiadomości.

• Obserwuj właściwy temat stanu i sprawdź, czy urządzenie wysyła aktualne dane.
• Jeżeli encja ma availability_topic, sprawdź komunikaty odpowiadające stanom online i offline oraz Last Will urządzenia.
• Po restarcie encja może czekać na nową wiadomość. Wiadomości retained mogą dostarczyć ostatni stan nowemu subskrybentowi, ale trzeba świadomie zdecydować, które dane powinny być zachowywane.
• Brak aktualnej wartości nie zawsze oznacza niedostępność urządzenia. O wyniku decydują konfiguracja encji, wiadomości dostępności i faktycznie otrzymane dane.

To jest diagnostyka stanu unavailable, a nie pełna instrukcja konfiguracji MQTT. Kontekst integracji i brokera opisuje poradnik o integracjach Home Assistant.

Przy pojedynczym urządzeniu sprawdź baterię lub zasilanie, ostatnią komunikację i zasięg do routerów Zigbee. Urządzenia bateryjne mogą spać i zgłaszać się rzadziej, dlatego brak połączenia na mapie sam w sobie nie musi oznaczać awarii.

Gdy jednocześnie znika wiele urządzeń, sprawdź koordynator, jego połączenie z Home Assistant i routery tworzące siatkę. Po restarcie lub zmianie koordynatora daj sieci czas na wznowienie komunikacji i nie paruj od razu wszystkiego ponownie.

Encja wynikowa może być niedostępna, mimo że jej własna konfiguracja się nie zmieniła. Wystarczy, że jedna z encji źródłowych przestała dostarczać dane. Sprawdź wszystkie źródła używane w szablonie oraz ich aktualne stany.

W szablonach obsłuż unknown i unavailable przed wykonywaniem obliczeń; oficjalna funkcja has_value() sprawdza, czy encja ma użyteczny stan. Nie zamieniaj automatycznie braku danych na zero, jeśli zero może uruchomić ogrzewanie, ładowanie, alarm lub inną błędną automatyzację.

Przy automatyzacjach świadomie określ zachowanie po utracie danych. Więcej zasad znajdziesz w poradniku Automatyzacje Home Assistant.

1. Otwórz właściwą integrację w Ustawienia → Urządzenia i usługi.
2. Z menu z trzema kropkami włącz debug logging tylko dla tej integracji.
3. Odtwórz problem raz i zanotuj godzinę.
4. Wyłącz debug logging; Home Assistant przygotuje log do pobrania.
5. Jeżeli opcja jest dostępna, pobierz diagnostykę z menu integracji albo konkretnego urządzenia.
6. Przed udostępnieniem otwórz plik i sprawdź, czy nie zawiera nazw, adresów, identyfikatorów lub innych danych wrażliwych. Integracje powinny je maskować, ale plik zawsze warto zweryfikować.

Debug generuje dużo wpisów, dlatego włączaj go na czas krótkiej, kontrolowanej próby, a potem wyłącz.

• Nie usuwaj integracji bez zapisania jej ustawień i zależności.
• Nie resetuj urządzenia do ustawień fabrycznych bez ustalenia, gdzie zanika komunikacja.
• Nie przywracaj całego backupu z powodu jednej encji.
• Nie zmieniaj kilku elementów jednocześnie. Po każdej próbie sprawdź rezultat.
• Nie restartuj wielokrotnie systemu bez zebrania logów, bo możesz zacierać moment wystąpienia błędu.

Jeżeli nie wiadomo, czy problem powoduje urządzenie, sieć, integracja, MQTT lub Home Assistant, opisz objawy. Najpierw sprawdzę, czy mogę realnie pomóc i jaki zakres diagnostyki będzie potrzebny.

Poradnik zweryfikowano 11 sierpnia 2026 r. na podstawie oficjalnej dokumentacji Home Assistant:

• stany encji i szablony,
• troubleshooting, debug logging i logi,
• diagnostyka integracji,
• Repairs,
• MQTT i ZHA.