Display lädt nicht oder zeigt Konfigurationsfehler

Wenn Ihr LobbyFlight-Display nicht lädt oder einen Konfigurationsfehler anzeigt, folgen Sie diesen Troubleshooting-Schritten.

Häufige Fehlermeldungen

Sie sehen möglicherweise eine dieser Meldungen:

Schnell-Checks (2 Minuten)

Bevor Sie tiefer troubleshooten, prüfen Sie diese häufigsten Ursachen:

1. Internet-Verbindung prüfen

[CODE_BLOCK]bash

Auf dem Display-Gerät testen:

ping google.com

oder

ping lobbyflight.com

[CODE_BLOCK]

Erwartetes Ergebnis: Pakete sollten ankommen (0% packet loss)

Falls Verbindung fehlt:

2. Display-URL verifizieren

Korrekte URL:

[CODE_BLOCK]

https://lobbyflight.com/display/[ihre-hotel-id]

[CODE_BLOCK]

Beispiel:

[CODE_BLOCK]

https://lobbyflight.com/display/a1b2c3d4-e5f6-7890-abcd-ef1234567890

[CODE_BLOCK]

Häufige Fehler:

Lösung:

3. Browser-Cache leeren

[CODE_BLOCK]

Chrome auf Android:

[CODE_BLOCK]

Ursache 1: Fehlende oder ungültige Hotel-Konfiguration

Technische Details

Code-Location: /app/api/config/[hotelId]/route.ts (Zeilen 47-54)

Das Display lädt Ihre Hotel-Konfiguration über die API:

[CODE_BLOCK]

GET /api/config/[hotelId]

[CODE_BLOCK]

Fehlschlag wenn:

Symptome

Schritt-für-Schritt-Lösung

Schritt 1: Hotel-ID prüfen

Öffnen Sie die Browser-Konsole (F12 oder Ctrl+Shift+I):

[CODE_BLOCK]javascript

// URL sollte sein:

window.location.pathname

// Ergebnis: "/display/a1b2c3d4-e5f6-..."

// Prüfen Sie die Config-Anfrage:

fetch('/api/config/a1b2c3d4-e5f6-...')

.then(r => r.json())

.then(console.log)

[CODE_BLOCK]

Erwartetes Ergebnis:

[CODE_BLOCK]json

{

"success": true,

"config": {

"name": "Ihr Hotel Name",

"airports": ["VIE"],

"logoUrl": "https://...",

"theme": { "primary": "#0A2463", ... }

}

}

[CODE_BLOCK]

Falls Error:

[CODE_BLOCK]json

{

"error": "Hotel not found"

}

[CODE_BLOCK]

Schritt 2: Account-Status prüfen

Schritt 3: Subscription-Status verifizieren

Gehen Sie zu: Portal → Billing → Subscription Status

Muss sein:

Falls "Past Due" oder "Cancelled":

Schritt 4: Demo-Modus testen

Testen Sie, ob das System generell funktioniert:

[CODE_BLOCK]

https://lobbyflight.com/display/demo

[CODE_BLOCK]

Falls Demo funktioniert:

Falls Demo NICHT funktioniert:

Ursache 2: Datenbank-Verbindung fehlgeschlagen

Technische Details

Code-Location: /app/api/config/[hotelId]/route.ts (Zeilen 45-50)

Die API benötigt Zugriff auf PostgreSQL-Datenbank:

[CODE_BLOCK]typescript

import { db } from '@/lib/db'

import { hotels } from '@/lib/db/schema'

const hotel = await db.query.hotels.findFirst({

where: eq(hotels.id, hotelId)

})

[CODE_BLOCK]

Fehlschlag wenn:

Symptome

Lösung (für Administratoren)

Prüfen Sie Environment Variables:

[CODE_BLOCK]bash

Auf dem Server:

echo $POSTGRES_URL

Sollte ausgeben: postgresql://user:pass@host:5432/db

Falls leer:

→ .env.local oder Vercel Environment Variables fehlen

[CODE_BLOCK]

Datenbank-Verbindung testen:

[CODE_BLOCK]bash

Mit psql:

psql "$POSTGRES_URL" -c "SELECT COUNT(*) FROM hotels;"

Erwartetes Ergebnis:

count

-------

42

[CODE_BLOCK]

Netzwerk testen:

[CODE_BLOCK]bash

Kann Server die DB erreichen?

telnet db-host.vercel-storage.com 5432

Oder:

nc -zv db-host.vercel-storage.com 5432

[CODE_BLOCK]

Falls Verbindung fehlschlägt:

Ursache 3: Browser-Kompatibilitätsprobleme

Symptome

Unterstützte Browser

✅ Empfohlen:

⚠️ Eingeschränkt:

❌ Nicht unterstützt:

Lösung

Auf Android-Display:

- Play Store → "Chrome" → Update

- Play Store → "Fully Kiosk Browser"

- Konfigurieren Sie Kiosk-Modus

- → Siehe Artikel "Kiosk Mode Setup"

- Chrome → Einstellungen → Über Chrome

- Version sollte sein: 120+ (Stand 2024)

JavaScript aktivieren:

[CODE_BLOCK]

Chrome → Einstellungen → Website-Einstellungen

→ JavaScript → Erlaubt

[CODE_BLOCK]

Hardware-Beschleunigung:

[CODE_BLOCK]

Chrome → Einstellungen → Erweitert

→ Hardware-Beschleunigung → Ein

[CODE_BLOCK]

Ursache 4: Service Worker Cache-Probleme

Technische Details

Code-Location: /public/sw.js (Service Worker)

LobbyFlight verwendet Service Workers für:

Problem: Alter Cache kann veraltete oder fehlerhafte Seiten anzeigen.

Symptome

Lösung

Service Worker neu registrieren:

Oder via Console:

[CODE_BLOCK]javascript

navigator.serviceWorker.getRegistrations().then(function(registrations) {

for(let registration of registrations) {

registration.unregister()

}

console.log('Service Workers removed')

location.reload(true) // Hard reload

})

[CODE_BLOCK]

Auf Android ohne DevTools:

[CODE_BLOCK]

Chrome → Einstellungen → Datenschutz & Sicherheit

→ Browserdaten löschen → Erweitert

→ Ankreuzen: "Cookies und Websitedaten"

→ Zeitraum: "Gesamte Zeit"

→ Daten löschen

[CODE_BLOCK]

Advanced Troubleshooting

Entwickler-Tools nutzen

Network Tab (Chrome DevTools):

Häufige Fehler:

Console Tab:

Suchen Sie nach Errors:

[CODE_BLOCK]

Error fetching config: Error: Failed query...

Error: Hotel not found, using default config

TypeError: Cannot read property 'name' of undefined

[CODE_BLOCK]

Screenshot dieser Errors für Support-Anfrage!

Logs sammeln

Browser Console Logs:

[CODE_BLOCK]javascript

// Exportieren für Support:

console.save = function(data, filename) {

const blob = new Blob([data], {type: 'text/plain'})

const link = document.createElement('a')

link.download = filename

link.href = window.URL.createObjectURL(blob)

link.click()

}

// Alle Logs speichern:

console.save(document.documentElement.innerHTML, 'display-debug.html')

[CODE_BLOCK]

API-Response speichern:

[CODE_BLOCK]bash

Mit curl testen:

curl -v "https://lobbyflight.com/api/config/ihre-hotel-id" > config-response.json

[CODE_BLOCK]

Netzwerk-Diagnostik

DNS prüfen:

[CODE_BLOCK]bash

nslookup lobbyflight.com

Sollte IP-Adresse zurückgeben

[CODE_BLOCK]

SSL-Zertifikat prüfen:

[CODE_BLOCK]bash

openssl s_client -connect lobbyflight.com:443 -servername lobbyflight.com

Zertifikat sollte gültig sein (not expired)

[CODE_BLOCK]

Firewall-Test:

[CODE_BLOCK]bash

Kann Port 443 erreicht werden?

telnet lobbyflight.com 443

[CODE_BLOCK]

Immer noch nicht gelöst?

Workaround: Demo-Modus verwenden

Temporär, bis Problem gelöst:

[CODE_BLOCK]

https://lobbyflight.com/display/demo

[CODE_BLOCK]

Hinweis: Demo-Modus zeigt Vienna (VIE) Live-Daten, aber:

Support kontaktieren

Sammeln Sie diese Informationen:

Kontakt:

Erwartete Response-Zeit:

Prävention

Best Practices

1. Bookmark die korrekte URL:

2. Regelmäßige Checks:

3. Monitoring einrichten:

4. Backup-Plan:

5. Dokumentation:

Verwandte Artikel

Technische Referenz

HTTP Status Codes

API Endpoints

[CODE_BLOCK]

GET /api/config/[hotelId]

→ Lädt Hotel-Konfiguration (Name, Logo, Farben, Airports)

GET /api/flights/[hotelId]?type=departures

→ Lädt Abflug-Daten

GET /api/weather/[airportCode]

→ Lädt Wetter-Daten

[CODE_BLOCK]

Cache-Strategie