Zum Hauptinhalt springen

Fehlerbehebung

Dieses Dokument sammelt häufige Probleme und deren Lösungen, die bei der Verwendung von Tianji auftreten können.

WebSocket-Verbindungsprobleme​

Problembeschreibung​

Bei der Nutzung von HTTPS-Diensten funktionieren andere Funktionen normal, aber der WebSocket-Dienst kann nicht ordnungsgemäß verbunden werden, was sich wie folgt zeigt:

  • Der Verbindungsstatusanzeiger in der unteren linken Ecke zeigt grau an
  • Die Serverseitenseitenliste zeigt Zählungen, aber keinen tatsächlichen Inhalt

Ursachenermittlung​

Dieses Problem wird meist durch unzureichende WebSocket-Weiterleitungsrichtlinien in der Reverse-Proxy-Software verursacht. In HTTPS-Umgebungen erfordern WebSocket-Verbindungen korrekte Cookie-Sicherheitsrichtlinien.

Lösung​

Sie können dieses Problem durch Setzen der folgenden Umgebungsvariable lösen:

AUTH_USE_SECURE_COOKIES=true

Diese Einstellung zwingt die Anwendung, Cookies, die vom Browser übermittelt werden, als verschlüsselte Cookies zu behandeln und löst somit die Probleme mit WebSocket-Verbindungen.

Konfigurationsmethoden​

Docker-Umgebung:

# docker-compose.yml
services:
  tianji:
    environment:
      - AUTH_USE_SECURE_COOKIES=true

Direkte Bereitstellung:

export AUTH_USE_SECURE_COOKIES=true

Überprüfungsschritte​

Nach der Konfiguration starten Sie den Dienst neu und überprüfen Sie:

  1. Der Verbindungsstatusanzeiger unten links sollte grün anzeigen
  2. Serverseiten sollten Echtzeitdaten normal anzeigen
  3. WebSocket-Verbindungen sollten ordnungsgemäß in den Entwickler-Tools des Browsers hergestellt werden

Wenn Sie auf andere Probleme stoßen, können Sie gerne ein Issue einreichen oder Lösungen zu dieser Dokumentation beitragen.