Connessione WebSocket non riuscita: come testarla e cosa significa l’errore 1006

Quando un browser dice che una connessione WebSocket non è riuscita, la causa è quasi sempre una di poche: un proxy che non fa passare i WebSocket, un handshake rifiutato dal server, un problema di certificato, oppure una connessione chiusa perché sembrava inattiva. Per scoprire quale, collegati allo stesso indirizzo con il nostro test WebSocket, leggi il codice di chiusura e poi controlla l’handshake.
Questo articolo passa in rassegna questi passi, e la soluzione per ogni causa.
Perché il browser ti dice così poco
Il tuo codice riceve un evento error senza dettagli, seguito da una chiusura con codice 1006. Quel codice non viene mai inviato da un server. RFC 6455 lo riserva a un endpoint per segnalare una connessione terminata senza un messaggio di chiusura, quindi dice solo che qualcosa è andato storto.
La vaghezza è voluta. Se una pagina potesse distinguere un handshake rifiutato da una porta chiusa, uno script potrebbe usarlo per scansionare la rete del visitatore. Quindi i dettagli sono nascosti al tuo codice e bisogna cercarli altrove:
- Gli strumenti per sviluppatori del browser. Nel pannello Rete, filtra per WS e seleziona la connessione. Mostra lo stato dell’handshake e ogni messaggio.
- La console. Il browser vi registra un motivo che il tuo codice non può leggere.
- I log del server e del proxy, che vedono ciò che il browser nasconde.
Passo 1: testa l’indirizzo
Apri il test WebSocket, inserisci l’indirizzo wss:// e collegati. Registra quanto ha impiegato la connessione, ogni messaggio nelle due direzioni e il codice di chiusura con il suo significato.
Se qui si collega e nella tua app no, confronta i due casi. Questo test ha un’origine tutta sua e nessun token della tua app, quindi la differenza di solito sta nell’autenticazione o in un controllo sull’origine. Se fallisce anche qui, provalo da un’altra rete, come l’hotspot di un telefono, per escludere una VPN o un proxy aziendale.
Passo 2: controlla l’handshake
Un WebSocket inizia come una richiesta HTTP, e curl ti mostra la risposta che il browser nasconde:
curl -i -N --http1.1 \
-H "Connection: Upgrade" \
-H "Upgrade: websocket" \
-H "Sec-WebSocket-Version: 13" \
-H "Sec-WebSocket-Key: SGVsbG8sIHdvcmxkIQ==" \
https://example.com/socketAggiungi -H "Origin: https://your-site.example" se il tuo server controlla da dove arriva una connessione. La prima riga della risposta dice quasi tutto:
101 Switching Protocols. L’handshake funziona, quindi guarda cosa succede dopo.200. La richiesta è arrivata a una pagina normale, quindi il proxy non la sta passando come WebSocket, oppure il percorso è sbagliato.400. Il server non ha accettato l’handshake. Alcuni server si aspettano dalla richiesta anche più di quanto contenga questa.401o403. L’autenticazione è fallita, oppure l’origine non è consentita.404. Nessuno è in ascolto su quel percorso.502,503o504. Il proxy non riesce a raggiungere il server dietro di sé.
Se curl segnala un errore di certificato, hai trovato la causa: un browser rifiuta la connessione allo stesso modo, e mostra al tuo codice lo stesso 1006.
Le cause più comuni e le soluzioni
Il proxy non fa passare i WebSocket. È la causa più comune. Un proxy deve inoltrare gli header di upgrade in modo esplicito, e in nginx si fa così:
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;
}Cade dopo circa un minuto. Proxy e bilanciatori di carico chiudono le connessioni che sembrano inattive, e il proxy_read_timeout di nginx è di 60 secondi se non lo cambi. Aumentarlo aiuta, ma invia un piccolo messaggio o un ping più spesso del timeout più breve lungo il percorso, perché non controlli tutti i proxy tra te e i tuoi utenti.
ws:// da una pagina HTTPS. I browser lo bloccano come contenuto misto, tranne ws:// verso localhost. Usa wss:// su una pagina servita in HTTPS.
L’origine viene rifiutata. I server spesso consentono connessioni solo dai propri siti e rifiutano le altre durante l’handshake. Aggiungi l’indirizzo del tuo sito all’elenco.
Non c’è modo di inviare header. Nessun browser può impostare header su un WebSocket, quindi un token in un header Authorization non arriva mai. Invialo nella query string, come sottoprotocollo o nel tuo primo messaggio.
Fallisce a ogni deploy. Un riavvio fa cadere tutte le connessioni. Riconnettiti con un ritardo crescente e casuale, così non tornano tutte insieme, e non dare per scontato che non ti sia sfuggito nulla nel frattempo.
Cosa dicono i codici di chiusura
Una volta aperta una connessione, vale la pena leggere il codice con cui si chiude:
- 1000: una chiusura normale, voluta.
- 1001: chi era dall’altra parte se ne va, per esempio un server che si spegne o la pagina che viene lasciata.
- 1006: nessun messaggio di chiusura, come sopra.
- 1008: il server ha rifiutato secondo le sue regole, spesso per l’autenticazione o l’origine.
- 1011: qualcosa è andato storto sul server.
- 1012 e 1013: un riavvio, oppure riprova più tardi.
Il test WebSocket li elenca tutti con il loro significato. I codici da 4000 in su appartengono al server o alla sua libreria.
Se preferisci non gestire il server
La maggior parte di questi problemi nasce dal gestire in proprio i websocket: il proxy, i timeout, i riavvii. I websocket in Python e in Laravel spiegano cosa richiede in ciascun framework, e perché gli hosting WordPress non reggono un websocket tratta l’hosting condiviso.
Con WordPlus Cloud la tua app si collega ai nostri server realtime tramite i nostri SDK, con stanze, presenza e riconnessioni, e non gestisci nessun server WebSocket. Il prezzo è a seconda delle connessioni, a partire da 1.000, e la documentazione ha una guida per ogni stack. Se una connessione verso di esso fallisce, il test di connessione mostra se quella rete raggiunge i nostri server.