WebSocket-Verbindung fehlgeschlagen: So testen Sie sie und was Fehler 1006 heißt

Wenn ein Browser meldet, dass eine WebSocket-Verbindung fehlgeschlagen ist, ist die Ursache fast immer eine von wenigen: ein Proxy, der WebSockets nicht durchlässt, ein Handshake, den der Server abgelehnt hat, ein Zertifikatsproblem oder eine Verbindung, die gekappt wurde, weil sie untätig wirkte. Um herauszufinden, welche es ist, verbinden Sie sich mit unserem WebSocket-Test mit derselben Adresse, lesen den Close-Code und prüfen dann den Handshake.
Dieser Beitrag geht diese Schritte durch, mit der Lösung für jede Ursache.
Warum der Browser so wenig verrät
Ihr Code erhält ein error-Ereignis ohne Details, gefolgt von einem Close mit dem Code 1006. Diesen Code sendet nie ein Server. RFC 6455 reserviert ihn für einen Endpunkt, der eine Verbindung meldet, die ohne Close-Nachricht endete. Er sagt also nur, dass etwas schiefgegangen ist.
Die Vagheit ist Absicht. Könnte eine Seite einen abgelehnten Handshake von einem geschlossenen Port unterscheiden, ließe sich damit das Netzwerk des Besuchers scannen. Deshalb bleiben die Details vor Ihrem Code verborgen, und Sie müssen woanders nachsehen:
- Die Entwicklerwerkzeuge des Browsers. Filtern Sie im Netzwerk-Tab nach WS und wählen Sie die Verbindung. Sie zeigt den Status des Handshakes und jede Nachricht.
- Die Konsole. Der Browser protokolliert dort einen Grund, den Ihr Code nicht lesen kann.
- Die Logs des Servers und des Proxys, die sehen, was der Browser verbirgt.
Schritt 1: Die Adresse testen
Öffnen Sie den WebSocket-Test, geben Sie die wss://-Adresse ein und verbinden Sie sich. Er protokolliert, wie lange die Verbindung gedauert hat, jede Nachricht in beide Richtungen und den Close-Code mit seiner Bedeutung.
Verbindet er sich hier und in Ihrer App nicht, vergleichen Sie die beiden. Dieser Test hat seinen eigenen Origin und keines der Tokens Ihrer App, der Unterschied liegt also meist bei der Authentifizierung oder einer Prüfung des Origins. Scheitert er auch hier, probieren Sie es aus einem anderen Netzwerk, etwa einem Hotspot am Telefon, um ein VPN oder einen Firmenproxy auszuschließen.
Schritt 2: Den Handshake prüfen
Ein WebSocket beginnt als HTTP-Anfrage, und curl zeigt Ihnen die Antwort, die der Browser verbirgt:
curl -i -N --http1.1 \
-H "Connection: Upgrade" \
-H "Upgrade: websocket" \
-H "Sec-WebSocket-Version: 13" \
-H "Sec-WebSocket-Key: SGVsbG8sIHdvcmxkIQ==" \
https://example.com/socketFügen Sie -H "Origin: https://your-site.example" hinzu, wenn Ihr Server prüft, woher eine Verbindung kommt. Die erste Zeile der Antwort sagt das Meiste:
101 Switching Protocols. Der Handshake funktioniert, sehen Sie sich also an, was danach passiert.200. Die Anfrage hat eine gewöhnliche Seite erreicht. Der Proxy reicht sie also nicht als WebSocket weiter, oder der Pfad stimmt nicht.400. Der Server hat den Handshake nicht angenommen. Manche Server erwarten auch mehr von einer Anfrage, als diese hier hat.401oder403. Die Authentifizierung ist gescheitert, oder der Origin ist nicht erlaubt.404. An diesem Pfad lauscht nichts.502,503oder504. Der Proxy erreicht den Server dahinter nicht.
Meldet curl einen Zertifikatsfehler, haben Sie die Ursache gefunden: Ein Browser lehnt die Verbindung auf dieselbe Weise ab und zeigt Ihrem Code dasselbe 1006.
Die üblichen Ursachen und ihre Lösungen
Der Proxy lässt WebSockets nicht durch. Das ist die häufigste. Ein Proxy muss die Upgrade-Header gezielt weiterreichen, und in nginx sieht das so aus:
location /socket {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 3600s;
}Sie bricht nach etwa einer Minute ab. Proxys und Load Balancer schließen Verbindungen, die untätig wirken, und das proxy_read_timeout von nginx beträgt 60 Sekunden, solange Sie es nicht ändern. Es zu erhöhen hilft, doch senden Sie öfter eine kleine Nachricht oder einen Ping, als das kürzeste Timeout auf dem Weg beträgt, denn Sie kontrollieren nicht jeden Proxy zwischen sich und Ihren Nutzern.
ws:// von einer HTTPS-Seite. Browser blockieren das als Mixed Content, mit Ausnahme von ws:// zu localhost. Nutzen Sie wss:// auf einer Seite, die über HTTPS ausgeliefert wird.
Der Origin wird abgelehnt. Server erlauben Verbindungen oft nur von ihren eigenen Websites und lehnen die übrigen beim Handshake ab. Tragen Sie die Adresse Ihrer Website in die Liste ein.
Es gibt keine Möglichkeit, Header zu senden. Kein Browser kann Header auf einem WebSocket setzen, ein Token in einem Authorization-Header kommt also nie an. Senden Sie es im Query-String, als Subprotokoll oder in Ihrer ersten Nachricht.
Sie scheitert bei jedem Deploy. Ein Neustart trennt jede Verbindung. Verbinden Sie sich mit einer wachsenden, zufälligen Verzögerung neu, damit nicht alle gleichzeitig zurückkommen, und gehen Sie nicht davon aus, dass in der Zwischenzeit nichts verpasst wurde.
Was die Close-Codes sagen
Hat sich eine Verbindung einmal geöffnet, lohnt es sich, den Code zu lesen, mit dem sie schließt:
- 1000: ein normales Schließen, mit Absicht.
- 1001: Weggang, etwa ein Server, der herunterfährt, oder eine verlassene Seite.
- 1006: keine Close-Nachricht, wie oben.
- 1008: Der Server hat nach seinen Regeln abgelehnt, oft wegen der Authentifizierung oder des Origins.
- 1011: Auf dem Server ist etwas schiefgegangen.
- 1012 und 1013: ein Neustart oder später erneut versuchen.
Der WebSocket-Test listet alle mit ihrer Bedeutung. Codes ab 4000 gehören dem Server oder seiner Bibliothek.
Wenn Sie den Server lieber nicht betreiben möchten
Das meiste entsteht dadurch, dass Sie Websockets selbst betreiben: den Proxy, die Timeouts, die Neustarts. Websockets in Python und Laravel gehen durch, was das in jedem Framework verlangt, und warum WordPress-Hosts keinen Websocket halten können behandelt Shared Hosting.
Mit WordPlus Cloud verbindet sich Ihre App über unsere SDKs mit unseren Realtime-Servern, mit Räumen, Präsenz und Wiederverbindung, und Sie betreiben keinen WebSocket-Server. Der Preis richtet sich nach Verbindungen, ab 1.000, und die Docs haben für jeden Stack eine Anleitung. Scheitert eine Verbindung dorthin, zeigt der Verbindungstest, ob dieses Netzwerk unsere Server erreicht.