# Anfänger-Fehlerbehebung

> Für Nutzerinnen und Nutzer, ohne Vorwissen. Technische Fehlerbehebung:
> [troubleshooting.md](troubleshooting.md). Häufige Fragen: [faq.md](faq.md).

Jeder Punkt folgt demselben Aufbau: Was sehe ich? → Wahrscheinliche Ursache → Was kann ich
gefahrlos selbst tun? → Wann brauche ich technische Hilfe? → Welche Informationen weitergeben?

## Seite lädt nicht

- **Was sehe ich?** Leere/weiße Seite oder eine Browser-Fehlermeldung.
- **Wahrscheinliche Ursache:** keine Internetverbindung, oder der Server ist gerade nicht erreichbar.
- **Was kann ich selbst tun?** Internetverbindung prüfen, Seite neu laden, ggf. später erneut
  versuchen.
- **Wann technische Hilfe?** Wenn das Problem länger als einige Stunden anhält.
- **Was weitergeben?** Uhrzeit, verwendetes Gerät/Browser, ob andere Websites funktionieren.

## Alte Ansicht

- **Was sehe ich?** Die App zeigt einen älteren Stand, neue Funktionen fehlen.
- **Wahrscheinliche Ursache:** der Browser hat noch eine ältere, zwischengespeicherte Version
  geladen.
- **Was kann ich selbst tun?** App vollständig schließen und neu öffnen; hilft das nicht, in den
  Browser-Einstellungen die Website-Daten für die App-Adresse löschen und neu installieren.
- **Wann technische Hilfe?** Wenn es auch nach einem vollständigen Neustart/Neuinstallieren
  bestehen bleibt.
- **Was weitergeben?** Gerät, Browser, ungefähr seit wann das Problem besteht.
- **Für Betreiber (v1.9.14):** trat vor v1.9.14 auch nach einem korrekten Deployment auf, wenn
  Cloudflare eine veraltete `app.js`/`pwa-data-lib.js` noch bis zu 4 Stunden am Edge cachte,
  während `index.html` bereits neu war (sichtbare Folge damals: neuer Button ohne Funktion, alte
  Überschrift). Seit v1.9.14 strukturell behoben (jede eigene JS-/CSS-Datei bekommt pro Release
  eine eindeutige URL, kein Cache kann sie mehr mit einer alten verwechseln) - siehe
  [pwa-cache-strategy.md](pwa-cache-strategy.md). Bleibt der Verdacht bestehen: Prüfschritte dort
  unter "Wie ein Deployment geprüft wird".

## Falscher Tagesblock wird angezeigt

- **Was sehe ich?** "Heute" zeigt scheinbar den falschen Tag/Zeitraum.
- **Wahrscheinliche Ursache:** meist ein Anzeigefehler durch eine falsche Systemzeit/Zeitzone des
  Geräts.
- **Was kann ich selbst tun?** Datum/Uhrzeit/Zeitzone des Geräts prüfen.
- **Wann technische Hilfe?** Wenn Datum/Uhrzeit korrekt sind und der Fehler bestehen bleibt.
- **Was weitergeben?** Gerätezeit, angezeigter vs. erwarteter Zeitraum.

## Wetter-Mail kommt zur falschen Uhrzeit

- **Was sehe ich?** Die Wetter-Mail (seit v1.11.0 stündliche Prüfung zwischen 06:00 und 21:00 Uhr,
  Versand aber weiterhin nur beim ersten Tageslauf oder bei einer deutlichen Änderung) kommt
  mitten in der Nacht oder zu einer sonst unerwarteten, verschobenen Uhrzeit an.
- **Wahrscheinliche Ursache:** ein Konfigurationsproblem auf der Betreiberseite (n8n-Zeitplan lief
  unter der falschen Zeitzone) — kein Fehler in der App oder auf dem eigenen Gerät. Seit v1.10.1
  ist die Zeitzone (`Europe/Berlin`) fest im Workflow verdrahtet und automatisiert getestet, siehe
  [n8n-setup.md](n8n-setup.md) „Verbindliche Zeitzone: Europe/Berlin" (für Betreiber).
- **Was kann ich selbst tun?** Nichts Technisches — das eigene Gerät oder die App ist nicht die
  Ursache. Datum/Uhrzeit des eigenen Geräts können zur Einordnung geprüft werden, ändern das
  Fehlerbild aber nicht.
- **Wann technische Hilfe?** Wenn die Verschiebung nach dem oben genannten Fix (v1.10.1 oder
  neuer) weiterhin auftritt.
- **Was weitergeben?** Erwartete vs. tatsächliche Empfangsuhrzeit, Datum, ob das Muster
  regelmäßig (jeden Tag um denselben verschobenen Versatz) oder nur einmalig auftrat.

## Keine aktuellen Daten

- **Was sehe ich?** Ein Hinweis auf veraltete Daten oder ein deutlich älteres Datum.
- **Wahrscheinliche Ursache:** die Datenquelle (n8n/Wetterdienst) hat länger nicht aktualisiert.
- **Was kann ich selbst tun?** Etwas warten und erneut laden.
- **Wann technische Hilfe?** Wenn die Daten über mehrere Stunden nicht aktueller werden.
- **Was weitergeben?** Angezeigtes Datenalter, Uhrzeit des Abrufs.

## "Jetzt gemessen" zeigt einen alten Wert / "Letzte verfügbare Messung"

- **Was sehe ich?** Die Beobachtungskarte oben in "Aktuell" zeigt "Letzte verfügbare Messung"
  statt "Aktuell gemessen", darunter eine Altersangabe wie "2 Stunden 25 Minuten alt".
- **Wahrscheinliche Ursache:** Das ist kein Fehler der App — die Wetterstation hat seit dieser Zeit
  einfach noch nicht neu gemessen. Ein App-Neustart macht einen alten Stationswert nicht frisch,
  siehe [observation-user-guide.md](observation-user-guide.md).
- **Was kann ich selbst tun?** Auf "Messdaten neu laden" tippen — das prüft sofort gezielt
  mehrere nahegelegene Stationen, kann aber keine neue Messung bei einer bestimmten Station
  erzwingen (das ist technisch nicht möglich). Seit v1.9.17 passiert diese Prüfung zusätzlich
  automatisch im Hintergrund (siehe [automatic-observation-refresh.md](automatic-observation-refresh.md))
  — eine kleine, unauffällige Zeile wie "Messstationen automatisch um 09:10 Uhr geprüft." unter dem
  Button ist normal und kein Hinweis auf ein Problem.
- **"Bitte warte kurz vor dem nächsten manuellen Abruf" erscheint:** normal, wenn der Button kurz
  zuvor schon gedrückt wurde (maximal ein manueller Abruf pro Minute).
- **Wann technische Hilfe?** Wenn "Aktuelle Messung nicht verfügbar" über mehrere Stunden bestehen
  bleibt.
- **Was weitergeben?** Angezeigtes Messalter, Ergebnis von "Messdaten neu laden".

## App verwalten zeigt eine unerwartete Plattform/Anleitung

- **Was sehe ich?** Im Reiter "Mehr" unter "App verwalten" passt die angezeigte Anleitung nicht
  zum tatsächlich verwendeten Gerät.
- **Wahrscheinliche Ursache:** die Plattformerkennung liest ausschließlich technische
  Browserangaben und ist bewusst als Einschätzung, nicht als Garantie gekennzeichnet (siehe
  [pwa-installation-management.md](pwa-installation-management.md) "Grenzen der Erkennung") — in
  seltenen Fällen (z. B. ungewöhnliche Browser-Einstellungen) kann sie danebenliegen.
- **Was kann ich selbst tun?** Die allgemeine Anleitung "im Browsermenü nach installierten Apps
  suchen" funktioniert plattformunabhängig als Fallback.

## Lokales Radar-Nowcasting zeigt "nicht genügend Radarbilder" oder "nicht verfügbar"

- **Was sehe ich?** Im Reiter „Radar" zeigt die Karte „Lokales Radar-Nowcasting" dauerhaft „Für
  eine verlässliche Bewegungsanalyse stehen derzeit nicht genügend Radarbilder zur Verfügung."
  oder „Radardaten derzeit nicht verfügbar.".
- **Wahrscheinliche Ursache:** entweder liegen (noch) zu wenige beobachtete Radarframes vor, die
  DWD-Radarquelle ist vorübergehend nicht erreichbar, oder die amtliche Legende konnte nicht
  ausgewertet werden — kein Fehler der App selbst, siehe
  [nowcasting-limitations.md](nowcasting-limitations.md).
- **Was kann ich selbst tun?** Prüfen, ob die normale Radarkarte darüber ebenfalls Probleme zeigt
  (dann liegt es an der DWD-Quelle insgesamt) oder normal funktioniert (dann ist nur die
  Nowcasting-Auswertung betroffen — technische Hilfe sinnvoll).
- **Das ist keine amtliche Warnung.** Diese Karte ersetzt niemals den Reiter „Warnungen".

## Wetterkamera lädt nicht automatisch / zeigt kein Bild

- **Was sehe ich?** Im Reiter "Radar" unter "Wetterkameras in der Umgebung" erscheint kein
  Kamerabild, nur ein Link "Beim Anbieter öffnen".
- **Das ist kein Fehler.** BENSA lädt Kamerabilder grundsätzlich nicht automatisch (Datenschutz)
  und bettet aktuell keine der geprüften Kameras direkt ein, da keine geklärte Einbettungserlaubnis
  vorliegt — siehe [weather-camera-evaluation.md](weather-camera-evaluation.md). Der Link öffnet
  die offizielle Seite des jeweiligen Anbieters in einem neuen Tab.

## Live-Modus zeigt "Verbindung unterbrochen" oder aktualisiert nicht

- **Was sehe ich?** Die Statuszeile im Reiter „Aktuell" zeigt dauerhaft „Verbindung unterbrochen"
  oder der Countdown bewegt sich nicht.
- **Wahrscheinliche Ursache:** keine Internetverbindung, oder der Browser-Tab war länger im
  Hintergrund (der Live-Modus pausiert dort bewusst, siehe [user-guide.md](user-guide.md#live-modus-v198)).
- **Was kann ich selbst tun?** Internetverbindung prüfen, App/Tab kurz in den Vordergrund holen
  (dann aktualisiert sie automatisch einmal sofort), oder den Knopf „🔄 Aktualisieren" antippen.
- **Wann technische Hilfe?** Wenn trotz funktionierender Internetverbindung dauerhaft „Verbindung
  unterbrochen" erscheint.
- **Was weitergeben?** Angezeigter Live-Status-Text, ob WLAN/Mobilfunk aktiv ist.

## Push funktioniert nicht

- **Was sehe ich?** Keine Benachrichtigungen, obwohl aktiviert.
- **Wahrscheinliche Ursache:** Browser-Berechtigung nicht erteilt, betroffene Kategorie deaktiviert,
  oder (iPhone) die App wurde nicht über "Zum Home-Bildschirm" installiert.
- **Was kann ich selbst tun?** Im Reiter „Mehr" die Push-Einstellungen und Kategorien prüfen, eine
  Testnachricht senden, Browser-Benachrichtigungsrechte in den Systemeinstellungen prüfen.
- **Wann technische Hilfe?** Wenn auch die Testnachricht nicht ankommt.
- **Was weitergeben?** Gerät, Browser, ob die Testnachricht ankam.

## Installationsknopf fehlt

- **Was sehe ich?** Kein sichtbarer "Installieren"-Button in "Mehr" → "Installation", oder kein
  Hinweis-Overlay beim Öffnen.
- **Wahrscheinliche Ursache**, in der Regel einer von drei Fällen (siehe
  [pwa-installation.md](pwa-installation.md) für die genaue Zustandslogik):
  1. **iOS/Safari** bietet grundsätzlich keinen automatischen Installations-Button — dort steht
     stattdessen immer eine Textanleitung ("In Safari auf „Teilen" tippen, dann „Zum
     Home-Bildschirm""). Das ist kein Fehler, sondern eine iOS-Einschränkung.
  2. **Bereits installiert:** läuft die App bereits im installierten (Standalone-)Modus, zeigt die
     Karte "Bereits installiert." und keinen Button — das ist der Erfolgsfall, nicht ein Problem.
  3. **Nicht unterstützter/anderer Browser** (z. B. manche Firefox-Versionen, oder Chrome/Edge,
     bevor der interne Installations-Hinweis des Browsers ausgelöst wurde): dort erscheint
     ersatzweise eine Textanleitung für den manuellen Weg über das Browser-Menü.
- **Was kann ich selbst tun?** In "Mehr" → "Installation" nachsehen, welcher der drei Fälle
  zutrifft (der angezeigte Text erklärt das bereits); siehe auch
  [user-guide.md](user-guide.md#installation) für den manuellen Weg je Gerät.
- **Wann technische Hilfe?** Wenn auch der in "Mehr" → "Installation" angezeigte manuelle Weg über
  das Browser-Menü nicht funktioniert.
- **Was weitergeben?** Gerät, Browser (inkl. Version), und der in "Mehr" → "Installation"
  angezeigte Text.

## "Neue Version verfügbar" verschwindet nicht

- **Was sehe ich?** Ein Banner am oberen Bildschirmrand mit dem Text "Eine neue Version von BENSA
  Wetter ist verfügbar." und einem Knopf "Jetzt aktualisieren", das auch nach dem Antippen wieder
  erscheint oder gar nicht verschwindet.
- **Wahrscheinliche Ursache:** der Service Worker hat eine neue Version im Hintergrund geladen,
  aber der Wechsel auf die neue Version ("Jetzt aktualisieren" antippen, danach lädt die Seite
  automatisch neu) wurde noch nicht abgeschlossen — oder mehrere geöffnete Tabs/Fenster derselben
  App verzögern die Aktivierung.
- **Was kann ich selbst tun?** Auf "Jetzt aktualisieren" tippen und warten, bis die Seite sich
  automatisch neu lädt; alle anderen offenen Tabs/Fenster der App schließen, falls das Banner
  danach weiterhin erscheint; App vollständig schließen und neu öffnen (siehe auch Abschnitt "Alte
  Ansicht" oben).
- **Wann technische Hilfe?** Wenn das Banner auch nach vollständigem Neustart der App über
  mehrere Tage hinweg bei jedem Öffnen erneut erscheint.
- **Was weitergeben?** Gerät, Browser, ob mehrere Tabs/Fenster der App gleichzeitig offen waren.

## Radar lädt nicht

- **Was sehe ich?** Fehlermeldung oder leere Karte im Radar-Reiter.
- **Wahrscheinliche Ursache:** die DWD-Radarquelle ist gerade nicht erreichbar (betrifft nur diesen
  Reiter).
- **Was kann ich selbst tun?** „Neu laden" antippen, später erneut versuchen.
- **Wann technische Hilfe?** Wenn es über mehrere Stunden anhält.
- **Was weitergeben?** Uhrzeit, angezeigte Fehlermeldung.

## Radar wird beim Hineinzoomen unscharf/blockartig

- **Was sehe ich?** Ab einer bestimmten Vergrößerung erscheinen einzelne, grobe Kästchen statt
  eines glatten Bildes, oder ein Hinweis „Maximale sinnvolle Radarvergrößerung erreicht".
- **Wahrscheinliche Ursache:** keine — das ist beabsichtigt. Das DWD-Radarraster hat eine feste
  physikalische Auflösung (1 km je Rasterzelle); ab einer bestimmten Zoomstufe werden diese Zellen
  einfach sichtbar. Die App wechselt bei „Region"/„Norddeutschland" automatisch zum schärferen
  „Nahbereich", statt das Bild künstlich weiter zu vergrößern.
- **Was kann ich selbst tun?** Nichts nötig — ggf. den Ausschnitt „Nahbereich" wählen.
- **Wann technische Hilfe?** Nur, wenn das Bild bereits bei normaler Ansicht (ohne Hineinzoomen)
  unscharf wirkt.

## Warnungen fehlen

- **Was sehe ich?** Der Warnungen-Reiter zeigt "keine aktiven amtlichen Warnungen", obwohl eine
  erwartet wurde.
- **Wahrscheinliche Ursache:** entweder liegt tatsächlich keine amtliche Warnung vor, oder die
  Warnquelle war kurzzeitig nicht erreichbar (siehe Quellenstatus-Anzeige).
- **Was kann ich selbst tun?** Quellenstatus im Warnungen-Reiter prüfen, ggf. offizielle
  DWD-Warnkarte zusätzlich prüfen.
- **Wann technische Hilfe?** Bei anhaltend gestörtem Quellenstatus.
- **Was weitergeben?** Uhrzeit, angezeigter Quellenstatus.

## E-Mail fehlt

- **Was sehe ich?** Keine tägliche Zusammenfassungs-E-Mail.
- **Wahrscheinliche Ursache:** Spam-Ordner, oder der E-Mail-Versand (n8n) ist ausgefallen.
- **Was kann ich selbst tun?** Spam-/Werbeordner prüfen, Absenderadresse als sicher markieren.
- **Wann technische Hilfe?** Wenn auch im Spam-Ordner nichts zu finden ist.
- **Was weitergeben?** Datum der letzten erhaltenen E-Mail.

## Service Worker veraltet

Siehe „Alte Ansicht" oben — derselbe Mechanismus.

## Browsercache

- **Was sehe ich?** Unerwartetes Verhalten, das durch einfaches Neuladen nicht verschwindet.
- **Was kann ich selbst tun?** Browser-Cache/Website-Daten für die App-Adresse gezielt löschen
  (nicht den gesamten Browser-Verlauf) und die App neu laden/neu installieren.

## GitHub-Fehlermail erhalten

Diese Mail betrifft ausschließlich die technische Entwicklung (automatisierte Tests) und **nicht**
die Nutzung der Wetter-App. Als Nutzerin/Nutzer können Sie diese Mail ignorieren; für Betreiber
siehe [troubleshooting.md](troubleshooting.md) Abschnitt „CI-Vorfall".

## Server nicht erreichbar

- **Was sehe ich?** Die App zeigt durchgehend "Server nicht erreichbar" oder veraltete Daten.
- **Wahrscheinliche Ursache:** der Server/Betrieb ist vorübergehend ausgefallen.
- **Was kann ich selbst tun?** Etwas warten und erneut versuchen.
- **Wann technische Hilfe?** Wenn es länger als einige Stunden anhält — dann ist der Betreiber
  gefragt, siehe [operator-handbook.md](operator-handbook.md).