ESPHome: API connection failed / disconnected
Home Assistant bzw. der API-Client verliert die Verbindung zum ESPHome-Gerät.
Kurz gesagt
WLAN-Abbrüche, Neustarts, falsche API-Verschlüsselung oder ein instabiles Netz sind häufige Ursachen.
Ändere nicht mehrere Dinge gleichzeitig. Mit den folgenden Schritten lässt sich die Ursache meist deutlich eingrenzen, ohne die bestehende Installation unnötig auseinanderzunehmen.
So gehst du jetzt vor
- Netzwerkerreichbarkeit des Geräts prüfen.
- ESPHome-Log auf Neustarts oder WLAN-Reconnects prüfen.
- API-Verschlüsselungsschlüssel kontrollieren.
- RSSI/AP-Wechsel bei Funkproblemen beobachten.
Warum die Meldung auftaucht
WLAN-Abbrüche, Neustarts, falsche API-Verschlüsselung oder ein instabiles Netz sind häufige Ursachen.
Wichtig ist der Zusammenhang: Zeitpunkt, betroffene Komponente und die Zeilen unmittelbar vor bzw. nach der Meldung. Ein einzelner Logsatz reicht nicht immer für eine eindeutige Diagnose.
Was du besser nicht sofort machst
Kein Werksreset, kein Löschen der Integration, kein Datenbank-Löschen und keine komplette Neuinstallation nur aufgrund dieser einen Meldung. Sichere vorher die Ausgangslage und arbeite den kleinsten sinnvollen Prüfschritt ab.
Häufige Fragen
Ist dieser Fehler kritisch?
Nicht automatisch. Entscheidend ist, ob die Meldung wiederkehrt und ob die betroffene Funktion tatsächlich gestört ist.
Muss ich neu installieren oder das Gerät löschen?
In der Regel nein. Zuerst Ursache, Erreichbarkeit und konkrete Konfiguration prüfen. Neuinstallation oder Löschen ist ein später Schritt, nicht der erste.
Kann ich den kompletten Log in den WATTZAHLS Fehler-Check werfen?
Ja, aber am besten nur den relevanten zusammenhängenden Block. Der Fehler-Check schwärzt typische sensible Werte vor der Analyse; Zugangsdaten und Tokens solltest du trotzdem nie bewusst mitsenden.
Passend dazu
Weiterführende Dokumentation: ESPHome Troubleshooting ↗