Blog

WebSocket veza nije uspjela: kako je testirati i što znači pogreška 1006

· Andrij Tkachenko · 4 min čitanja

Utikač i utičnica malo razdvojeni, s iskricama u procjepu i povećalom iznad njega

Kad preglednik kaže da WebSocket veza nije uspjela, uzrok je gotovo uvijek jedan od nekoliko njih: proxy koji ne propušta WebSockete, rukovanje koje je poslužitelj odbio, problem s certifikatom ili veza prekinuta jer je izgledala neaktivno. Da biste saznali koji, spojite se na istu adresu našim WebSocket testom, pročitajte kod zatvaranja, a zatim provjerite rukovanje.

Ovaj članak prolazi kroz te korake i ispravak za svaki uzrok.

Zašto vam preglednik govori tako malo

Vaš kod dobiva događaj error bez ikakvih pojedinosti, a za njim zatvaranje s kodom 1006. Taj kod poslužitelj nikad ne šalje. RFC 6455 rezervira ga da krajnja točka njime prijavi vezu koja je završila bez poruke o zatvaranju, pa kaže samo da je nešto pošlo po zlu.

Neodređenost je namjerna. Kad bi stranica mogla razlikovati odbijeno rukovanje od zatvorenog porta, skripta bi to mogla koristiti za skeniranje posjetiteljeve mreže. Zato su pojedinosti skrivene od vašeg koda i morate ih potražiti drugdje:

  • Razvojni alati preglednika. U ploči Network filtrirajte po WS i odaberite vezu. Prikazuje status rukovanja i svaku poruku.
  • Konzola. Preglednik ondje bilježi razlog koji vaš kod ne može pročitati.
  • Zapisnici poslužitelja i proxyja, koji vide ono što preglednik skriva.

Korak 1: testirajte adresu

Otvorite WebSocket test, upišite adresu wss:// i spojite se. Bilježi koliko je veza trajala, svaku poruku u oba smjera te kod zatvaranja s onim što znači.

Ako se ovdje spoji, a u vašoj aplikaciji ne, usporedite to dvoje. Ovaj test ima vlastiti izvor i nijedan token vaše aplikacije, pa je razlika obično u autentifikaciji ili provjeri izvora. Ako ne uspije ni ovdje, probajte iz druge mreže, poput hotspota na mobitelu, da isključite VPN ili proxy tvrtke.

Korak 2: provjerite rukovanje

WebSocket počinje kao HTTP zahtjev, a curl vam pokazuje odgovor koji preglednik skriva:

Shell
curl -i -N --http1.1 \
  -H "Connection: Upgrade" \
  -H "Upgrade: websocket" \
  -H "Sec-WebSocket-Version: 13" \
  -H "Sec-WebSocket-Key: SGVsbG8sIHdvcmxkIQ==" \
  https://example.com/socket

Dodajte -H "Origin: https://your-site.example" ako vaš poslužitelj provjerava odakle veza dolazi. Prvi redak odgovora kaže najviše:

  • 101 Switching Protocols. Rukovanje radi, pa pogledajte što se događa nakon njega.
  • 200. Zahtjev je stigao do obične stranice, pa ga proxy ne prosljeđuje kao WebSocket ili je putanja pogrešna.
  • 400. Poslužitelj nije prihvatio rukovanje. Neki poslužitelji od zahtjeva očekuju i više nego što ovaj ima.
  • 401 ili 403. Autentifikacija nije uspjela ili izvor nije dopušten.
  • 404. Ništa ne sluša na toj putanji.
  • 502, 503 ili 504. Proxy ne može doći do poslužitelja iza sebe.

Ako curl javi pogrešku certifikata, pronašli ste uzrok: preglednik odbija vezu na isti način i vašem kodu pokazuje isti 1006.

Uobičajeni uzroci i njihovi ispravci

Proxy ne propušta WebSockete. Ovo je najčešće. Proxy mora namjerno proslijediti zaglavlja nadogradnje, a u nginxu to izgleda ovako:

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;
}

Prekida se nakon otprilike minute. Proxyji i balanseri opterećenja zatvaraju veze koje izgledaju neaktivno, a nginxov proxy_read_timeout iznosi 60 sekundi ako ga ne promijenite. Povećanje pomaže, ali šaljite malu poruku ili ping češće od najkraćeg isteka vremena na putu, jer ne upravljate svakim proxyjem između sebe i svojih korisnika.

ws:// sa stranice na HTTPS-u. Preglednici to blokiraju kao miješani sadržaj, osim ws:// prema localhostu. Koristite wss:// na stranici koja se poslužuje preko HTTPS-a.

Izvor je odbijen. Poslužitelji često dopuštaju veze samo sa svojih stranica, a ostale odbijaju pri rukovanju. Dodajte adresu svoje stranice na popis.

Nema načina za slanje zaglavlja. Nijedan preglednik ne može postaviti zaglavlja na WebSocketu, pa token u zaglavlju Authorization nikad ne stiže. Pošaljite ga u upitu, kao podprotokol ili u prvoj poruci.

Ne uspijeva pri svakom puštanju u rad. Ponovno pokretanje prekida svaku vezu. Ponovno se spajajte s rastućim, nasumičnim odmakom da se ne vrate sve odjednom i ne pretpostavljajte da ništa nije propušteno dok vas nije bilo.

Što kažu kodovi zatvaranja

Kad se veza otvori, vrijedi pročitati kod kojim se zatvara:

  • 1000: uobičajeno zatvaranje, namjerno.
  • 1001: odlazak, primjerice gašenje poslužitelja ili napuštanje stranice.
  • 1006: nema poruke o zatvaranju, kao gore.
  • 1008: poslužitelj je odbio prema svojim pravilima, često zbog autentifikacije ili izvora.
  • 1011: na poslužitelju je nešto pošlo po zlu.
  • 1012 i 1013: ponovno pokretanje ili pokušajte kasnije.

WebSocket test navodi sve njih s onim što znače. Kodovi od 4000 nadalje pripadaju poslužitelju ili njegovoj biblioteci.

Ako radije ne biste vodili poslužitelj

Većina ovoga proizlazi iz vođenja vlastitih websocketa: proxy, istek vremena, ponovna pokretanja. Websocketi u Pythonu i Laravelu prolaze kroz to što je za to potrebno u svakom frameworku, a zašto WordPress hostovi ne mogu držati websocket obrađuje zajednički hosting.

S WordPlus Cloudom vaša se aplikacija preko naših SDK-ova spaja na naše poslužitelje u stvarnom vremenu, sa sobama, prisutnošću i ponovnim spajanjem, a vi ne vodite nikakav WebSocket poslužitelj. Cijena ovisi o vezama, od 1000 nadalje, a dokumentacija ima vodič za svaki stack. Ako veza na njega ne uspije, test veze pokazuje dopire li ta mreža do naših poslužitelja.