Fehlerhilfe und FAQ

Fehlerhilfe und häufige Fragen

Zuerst kontrollieren

1. Installierte Version im Internal VERSION am CMS-Device ansehen.
2. Prüfen, ob du main oder bewusst dev verwendest.
3. Nach Modulupdate FHEM neu starten und Browser vollständig neu laden.
4. Fehlermeldung im Dialog und FHEM-Log lesen.
5. Bei unklarem Schreibstatus zuerst erneut laden, nicht mehrfach speichern.

Installation und Anzeige

Symptom	Prüfung / Abhilfe
Nach Update erscheint altes Verhalten	Neustart bei Moduländerung; bei reinem Frontendupdate set CMS rebuild; Browser hart neu laden, Proxycache berücksichtigen.
Update meldet „nothing to do“	Richtige Controls-URL prüfen; nach Veröffentlichung automatische Generierung abwarten.
Modul oder Oberfläche fehlt	Vollständige Controls-Quelle statt einzelner .pm-Datei installieren; Update-/Startlog prüfen.
„Konfiguration konnte nicht geladen werden“	Existenz und Rechte der privaten Daten, FHEMWEB-Sitzung und FHEM-Log prüfen.
Bestehende Startseite wird nicht erneuert	Dateien ohne Modul-Marker werden nicht überschrieben; vor manueller Reparatur sichern und Herkunft prüfen.
Nach Installation fehlt die neue Versionsnummer	Tatsächlich verwendetes CMS-Device, Updatequelle und durchgeführten Neustart prüfen.

Speichern und Veröffentlichen

Warum zeigt die Homepage noch den alten Stand?

Speichern ist nicht Veröffentlichen. Im Editor Datei → Entwurf veröffentlichen ausführen und die Homepage neu laden. Vorschau zeigt den Entwurf, die normale Homepage dagegen Live.

Warum passt der Editor nicht zum Vorschaufenster?

Gleiche Inhaltsbreite, Browserzoom und geladenen Stand vergleichen. Geräte-Vorschau kann bewusst eine andere Breite simulieren. Bis 600 Pixel Inhaltsbreite wird die Ansicht umgebrochen, der Editor bleibt beim exakten Raster. Details: Layout.

„Veralteter Zustand“ oder Konflikt beim Speichern

Ein anderer Tab oder Benutzer kann inzwischen gespeichert haben. Zustand neu laden und die gewünschte Änderung auf dem aktuellen Stand erneut vornehmen. Keine Zustandsprüfung durch direkte JSON-Manipulation umgehen.

Warum sind Knöpfe zeitweise gesperrt?

Während laufender Speicherung werden konkurrierende Aktionen verhindert. Bei verlorener Antwort den Zustand erneut laden.

Geräte und Werte

Symptom	Prüfung / Abhilfe
– statt eines Werts	Exakten Device-/Readingnamen, Kanalzuordnung und vorhandenen Readingwert prüfen.
„Veraltet seit …“	Verbindung, FHEMWEB-Anmeldung, HTTP-Fehler und Rechte prüfen; alter Wert ist nicht aktuell.
Werte kommen nur etwa alle 30 Sekunden	WebSocket-Inform bzw. Proxyweiterleitung prüfen; Polling ist Rückfall.
Schalter/Taster reagiert im Editor nicht	Gewollt; echte Bedienung erfolgt in der Ansicht.
Thermostat verwendet falsche Daten	Neu zugeordnetes Device und dessen Readings/Set-Befehle im Dialog prüfen, speichern und erneut öffnen.
Device fehlt beim Slider	Es muss einen Set-Befehl mit :slider,min,step,max anbieten; reine Temperaturwertelisten reichen derzeit nicht.
kWh-Wert ist um Faktor 1000 falsch	Einheit ist oft nur Beschriftung; die tatsächliche Skalierung des Quellreadings prüfen.
SolarFlow zeigt falsche Richtung	Vorzeichenkonvention und W-/kW-Einstellung prüfen, nicht allein die Beschriftung ändern.
Uhrzeit stimmt nicht	Browsergerät und dessen Zeitzone/Uhrzeit kontrollieren.

Historie

• Das Diagramm bietet nur tatsächlich geloggte Readings an.
• Bei FileLog muss die Regexp das Reading umfassen.
• Bei mehreren Quellen dbLog, fileLog und historySource prüfen.
• Nichtnumerische Werte werden nicht als Kurve dargestellt.
• Lange DbLog-Abfragen können FHEM blockieren.

Details: Historische Daten.

Assets

Warum finde ich eine hochgeladene Datei nicht?

Den Zielordner und den Pfad prüfen. Bei identischer Datei kann der vorhandene Asseteintrag wiederverwendet worden sein und in seinem bisherigen Ordner bleiben. Der Stammordner zeigt nicht rekursiv alle Inhalte. Eine Suche gibt es noch nicht.

Warum bleibt eine Datei nach Abbrechen des Widgets bestehen?

Uploads sind sofortige Assetaktionen, keine vorläufigen Dialogeingaben. Abbrechen oder Entwurf verwerfen löscht diese Datei nicht.

Warum kann ich die Datei nicht löschen?

Verwendungen anzeigen öffnen. Fundstellen in gespeicherten Live- und Entwurfsseiten zuerst entfernen. Die serverseitige Prüfung schützt auch dann, wenn nach der ersten Prüfung ein neuer Verweis gespeichert wurde.

Warum kann ich die Endung nicht ändern?

Die Endung gehört zum erkannten Dateityp und ist bewusst geschützt. Umbenennen ändert den Anzeigenamen, nicht die Hash-Datei im Dateisystem.

Warum fehlt das EXIF-i?

Nicht jedes Bild enthält EXIF. Bei erfolgreicher Prüfung ohne Metadaten ist kein i vorhanden. Einen ausdrücklich gemeldeten Lesefehler dagegen separat prüfen.

Warum scheitert der Upload?

Dateityp, tatsächliches Format, Einzel-/Gesamtlimit, Kataloggrenze, laufenden anderen Upload und FHEMWEB-Verbindung prüfen. Der erste Fehler stoppt den Auftrag; bereits abgeschlossene Dateien bleiben erhalten. Ganze Ordner lassen sich nicht per Drop importieren.

Layout und Links

• Die Navigation gilt für alle Seiten; Vergrößern kann andere Widgets verdrängen.
• Auf Touchgeräten bleiben Werkzeuge ohne Hover sichtbar.
• Ein neues Browserfenster kann aufgrund von Browserregeln als Tab erscheinen.
• Versteckte Seiten sind nicht automatisch geschützt.
• LinkWidget-Kacheln dürfen sich nicht überlappen.

Fehler melden

Ein Issue erstellen und angeben:

• Modulversion, Browser und Betriebssystem.
• Erwartetes und tatsächliches Verhalten.
• Kurze reproduzierbare Schritte.
• Modus: Editor, Vorschau oder Homepage.
• Bei Layoutfehlern Fenster-/Inhaltsbreite und Zoomfaktor.
• Bereinigte Fehlermeldung und gegebenenfalls neutraler Screenshot.

Keine Zugangsdaten, Tokens, privaten Adressen, GPS-Metadaten oder ungeprüften Konfigurationsdateien veröffentlichen.

Startseite · Sicherungen