Blog

Échec de connexion WebSocket : comment la tester et ce que veut dire l’erreur 1006

· Andrij Tkachenko · 5 min de lecture

Une prise et son socle légèrement écartés avec de petites étincelles dans l’espace et une loupe au-dessus

Quand un navigateur dit qu’une connexion WebSocket a échoué, la cause est presque toujours l’une de quelques-unes : un proxy qui ne laisse pas passer les WebSockets, une poignée de main que le serveur a refusée, un problème de certificat, ou une connexion coupée parce qu’elle semblait inactive. Pour savoir laquelle, connectez-vous à la même adresse avec notre test WebSocket, lisez le code de fermeture, puis vérifiez la poignée de main.

Cet article passe en revue ces étapes, et la solution pour chaque cause.

Pourquoi le navigateur en dit si peu

Votre code reçoit un événement error sans détails, suivi d’une fermeture avec le code 1006. Ce code n’est jamais envoyé par un serveur. La RFC 6455 le réserve à un point de terminaison pour signaler une connexion terminée sans message de fermeture, il dit donc seulement que quelque chose s’est mal passé.

Ce flou est voulu. Si une page pouvait distinguer une poignée de main refusée d’un port fermé, un script pourrait s’en servir pour scanner le réseau du visiteur. Les détails sont donc cachés à votre code, et il faut les chercher ailleurs :

  • Les outils de développement du navigateur. Dans le panneau Réseau, filtrez sur WS et sélectionnez la connexion. Il montre le statut de la poignée de main et chaque message.
  • La console. Le navigateur y consigne une raison que votre code ne peut pas lire.
  • Les journaux du serveur et du proxy, qui voient ce que le navigateur cache.

Étape 1 : tester l’adresse

Ouvrez le test WebSocket, saisissez l’adresse wss:// et connectez-vous. Il consigne la durée de la connexion, chaque message dans les deux sens, et le code de fermeture avec sa signification.

Si cela se connecte ici et pas dans votre appli, comparez les deux. Ce test a sa propre origine et aucun des jetons de votre appli, la différence est donc en général l’authentification ou une vérification de l’origine. Si cela échoue aussi ici, essayez depuis un autre réseau, comme le partage de connexion d’un téléphone, pour écarter un VPN ou un proxy d’entreprise.

Étape 2 : vérifier la poignée de main

Un WebSocket commence comme une requête HTTP, et curl vous montre la réponse que le navigateur cache :

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

Ajoutez -H "Origin: https://your-site.example" si votre serveur vérifie d’où vient une connexion. La première ligne de la réponse en dit l’essentiel :

  • 101 Switching Protocols. La poignée de main fonctionne, regardez donc ce qui se passe après.
  • 200. La requête est arrivée sur une page ordinaire, donc le proxy ne la transmet pas comme un WebSocket, ou le chemin est faux.
  • 400. Le serveur n’a pas accepté la poignée de main. Certains serveurs attendent aussi plus d’une requête que celle-ci.
  • 401 ou 403. L’authentification a échoué, ou l’origine n’est pas autorisée.
  • 404. Rien n’écoute à ce chemin.
  • 502, 503 ou 504. Le proxy ne peut pas joindre le serveur derrière lui.

Si curl signale une erreur de certificat, vous avez trouvé la cause : un navigateur refuse la connexion de la même façon, et montre à votre code le même 1006.

Les causes habituelles et leurs solutions

Le proxy ne laisse pas passer les WebSockets. C’est la plus courante. Un proxy doit transmettre exprès les en-têtes d’upgrade, et dans nginx cela ressemble à ceci :

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

Elle coupe au bout d’environ une minute. Les proxys et les répartiteurs de charge ferment les connexions qui semblent inactives, et le proxy_read_timeout de nginx est de 60 secondes si vous ne le changez pas. L’augmenter aide, mais envoyez un petit message ou un ping plus souvent que le plus court délai du chemin, car vous ne contrôlez pas tous les proxys entre vous et vos utilisateurs.

ws:// depuis une page HTTPS. Les navigateurs le bloquent comme du contenu mixte, sauf ws:// vers localhost. Utilisez wss:// sur une page servie en HTTPS.

L’origine est refusée. Les serveurs n’autorisent souvent les connexions que depuis leurs propres sites, et refusent les autres pendant la poignée de main. Ajoutez l’adresse de votre site à la liste.

Il n’y a aucun moyen d’envoyer des en-têtes. Aucun navigateur ne peut définir d’en-têtes sur un WebSocket, donc un jeton dans un en-tête Authorization n’arrive jamais. Envoyez-le dans la chaîne de requête, comme sous-protocole, ou dans votre premier message.

Elle échoue à chaque déploiement. Un redémarrage coupe toutes les connexions. Reconnectez-vous avec un délai croissant et aléatoire pour qu’elles ne reviennent pas toutes en même temps, et ne supposez pas que rien n’a été manqué pendant l’absence.

Ce que disent les codes de fermeture

Une fois qu’une connexion s’est ouverte, le code avec lequel elle se ferme mérite d’être lu :

  • 1000 : une fermeture normale, voulue.
  • 1001 : départ, comme un serveur qui s’arrête ou la page quittée.
  • 1006 : pas de message de fermeture, comme plus haut.
  • 1008 : le serveur a refusé selon ses règles, souvent l’authentification ou l’origine.
  • 1011 : quelque chose s’est mal passé côté serveur.
  • 1012 et 1013 : un redémarrage, ou réessayez plus tard.

Le test WebSocket les liste tous avec leur signification. Les codes à partir de 4000 appartiennent au serveur ou à sa bibliothèque.

Si vous préférez ne pas faire tourner le serveur

L’essentiel vient du fait de faire tourner soi-même des websockets : le proxy, les délais, les redémarrages. Les websockets en Python et dans Laravel passent en revue ce que cela demande dans chaque framework, et pourquoi les hébergeurs WordPress ne peuvent pas tenir un websocket traite de l’hébergement mutualisé.

Avec WordPlus Cloud, votre appli se connecte à nos serveurs temps réel par nos SDK, avec salles, présence et reconnexions, et vous ne faites tourner aucun serveur WebSocket. Il est tarifé selon les connexions, à partir de 1 000, et la documentation a un guide pour chaque stack. Si une connexion y échoue, le test de connexion montre si ce réseau atteint nos serveurs.