2026-06-02

Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion

Comment résoudre les échecs de mise à niveau de WebSocket avec les captures de paquets, y compris HTTP 101, les en-têtes de mise à niveau, les en-têtes de connexion, la suppression de proxy, TLS, les réinitialisations et les délais d'inactivité.

Les échecs WebSocket se cachent souvent derrière des messages génériques de navigateur ou d'application: "Échec de la connexion WebSocket", "Code de réponse inattendu", "Connexion fermée avant de recevoir une réponse de poignée de main", "101 protocoles de commutation manquants" ou "socket déconnecté". Les utilisateurs recherchent « Échec de la mise à niveau WebSocket pcap », « 101 protocoles de commutation non renvoyés », « en-têtes de proxy WebSocket nginx » et « réinitialisation de la connexion WebSocket » lorsque HTTP semble fonctionner mais pas le trafic en temps réel." Une capture de paquets peut montrer si la demande de mise à niveau HTTP a été envoyée, si le serveur a renvoyé « 101 protocoles de commutation », si un proxy a supprimé les en-têtes requis, si TLS a réussi et si la connexion a été interrompue après la mise à niveau.

La chirurgie PCAP est utile car les traces WebSocket nécessitent souvent de préserver à la fois la prise de contact HTTP et la chronologie TCP après la mise à niveau.

À quoi ressemble une mise à niveau saine de WebSocket

Un client envoie une requête HTTP avec les en-têtes de mise à niveau :

GET /socket HTTP/1.1
Host: example.com
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key: ...
Sec-WebSocket-Version: 13

The server replies:

HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: ...

Après cela, la connexion n’est plus un trafic de requête/réponse HTTP ordinaire. Il transporte des trames WebSocket.

Échecs de mise à niveau courants

Les causes courantes incluent :

Le proxy supprime l'en-tête « Mise à niveau ».
Le proxy supprime ou réécrit « Connexion : mise à niveau ».
La route backend ne prend pas en charge WebSocket.
La terminaison TLS envoie une requête au mauvais amont.
Le comportement de mise à niveau de HTTP/2 vers HTTP/1.1 est mal configuré.
La redirection d'authentification se produit au lieu de 101.
Le backend renvoie 400, 403, 404, 426, 502 ou 504.
La connexion est réinitialisée après la mise à niveau.
Le délai d'inactivité ferme le WebSocket silencieux.

Le code d'état et les en-têtes sont importants.

Problèmes d'en-tête de proxy

Les proxys inverses doivent transmettre correctement les en-têtes de mise à niveau WebSocket. Si le backend ne voit jamais « Mise à niveau : websocket », il peut traiter la requête comme un HTTP ordinaire.

Preuve par paquets :

La requête client-proxy inclut les en-têtes de mise à niveau.
La requête proxy vers backend en manque.
Le backend renvoie une réponse HTTP normale au lieu de 101.

Il s'agit d'un problème de configuration de proxy, pas d'un bug du client WebSocket.

TLS et SNI

Pour WebSocket sécurisé (wss://), TLS se produit avant la mise à niveau HTTP. Si TLS échoue, la négociation WebSocket ne commence jamais. Préservez DNS, TCP, TLS ClientHello, SNI et toute alerte ou réinitialisation TLS.

Ne diagnostiquez pas les en-têtes de mise à niveau tant que le chemin TLS n’est pas prouvé.

La connexion est interrompue après 101

Parfois, la mise à niveau réussit, puis la connexion est fermée. C’est un autre échec.

Rechercher:

Expéditeur FIN ou RST.
Durée du délai d'inactivité.
Activité de ping/pong WebSocket.
Expiration du délai de lecture du proxy.
Retransmissions TCP.
Zéro fenêtre.
Redémarrage du processus backend.

Si la chute se produit à un intervalle fixe, une politique de délai d'attente est probable.

Checklist

Utilisez ce flux de travail :

Préservez les connexions DNS et TCP.
Vérifiez la négociation TLS pour wss://.
Inspectez les en-têtes de demande de mise à niveau du client.
Inspectez l’état de réponse du serveur.
Confirmez « 101 protocoles de commutation » si prévu.
Comparez les requêtes client-proxy et proxy-backend.
Recherchez des redirections ou des réponses d'authentification.
Si la mise à niveau réussit, inspectez FIN/RST/timeout après la mise à niveau.
Conservez le timing ping/pong de WebSocket s’il est visible.
Coupez seulement après avoir gardé la poignée de main complète.

Diagnostic final

Les échecs de mise à niveau de WebSocket sont généralement dus à des problèmes de négociation HTTP ou de transfert de proxy jusqu'à ce que « 101 protocoles de commutation » soit prouvé. Après la mise à niveau, les échecs se transforment en problèmes de longue durée d'expiration TCP, de réinitialisation ou de protocole d'application.

PCAP Surgery aide à préserver les deux phases afin qu'une vague erreur WebSocket puisse être attribuée aux en-têtes, au comportement du proxy, à TLS, à la réponse du backend ou à la durée de vie de la connexion.

Réponse fondée sur les paquets pour « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion »

La réponse directe est qu’un label d’analyse ou un message applicatif ne suffit pas à désigner la cause. Commencez par le point de capture et la direction, puis prouvez la dernière frontière réussie et la première en échec. Pour « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion », un autre lecteur doit retrouver le packet, le trou ou l’intervalle soutenant chaque phrase et savoir quel élément pourrait la réfuter.

Placer la capture sur le chemin

Consignez client, serveur et tout proxy, load balancer, NAT ou firewall. Indiquez interface, lieu, horloge, système et directions visibles. Une capture côté client prouve ce qui y arrive, pas que le serveur n’a rien envoyé. Côté serveur, elle prouve la sortie à cet endroit, pas le trajet. Avant de comparer deux points, corrigez clock offset et alignez flow tuple, TCP sequence ou transaction ID.

Vérifiez snap length, dropped packets, offload, capture filter, ring buffer et heure de départ. Un mauvais checksum sur l’hôte peut être un offload artifact. Un grand segment peut venir de GRO/TSO sans exister ainsi sur le fil. Un packet absent d’un fichier limité n’est pas une network loss tant que le point devait réellement le voir.

Lire les frontières dans l’ordre

Frontière	Preuve de réussite	Preuve d’échec utile
Link et IP	direction, adresses et route cohérentes	ARP/NDP absent, ICMP, MTU, asymétrie
TCP	SYN, SYN-ACK, ACK et sequence	retransmission, RST, zero window, timeout
TLS	ClientHello, ServerHello et progression	alert ou frontière SNI/ALPN/certificate
Application	request complet et réponse associée	status, trou ou fermeture précoce
Usage	response time ou failure window	blocage lié à une frontière

Arrêtez-vous à la première frontière sans réussite. Si TCP n’est pas établi, ne commencez pas par HTTP. Si le request atteint le proxy mais pas l’upstream, la limite se situe dans le proxy ou son chemin. S’il atteint l’upstream sans response avant timeout, ACK et progression des bytes séparent application delay et network loss.

Séparer observation et hypothèse

Une observation est pointable : « Le client a envoyé jusqu’à une sequence, l’émetteur a répété un segment trois fois et aucun ACK progressif n’apparaît ici. » L’hypothèse est : « le chemin a perdu le segment ». Une autre capture ou des dropped records peuvent la réfuter. Pour chaque hypothèse, écrivez une preuve favorable et une preuve contraire.

Retransmission ou duplicate ACK ne désigne pas le responsable. Reordering, loss, capture artifact et receiver delay peuvent produire des labels proches. Reliez direction, sequence, ACK, SACK, RTT, window et temps applicatif. Pour DNS/DHCP, associez transaction ID, adresses et essais ; pour HTTP, request et response ; pour TLS, direction du handshake.

Préserver l’original

Calculez le checksum et gardez l’original inchangé. Filtrez, coupez et masquez une working copy. Journalisez input, transformation, heure, packet count avant/après, checksum résultat et motif. Après timestamp rewrite ou suppression de packets, cette copie ne convient plus à certaines mesures de temps ou de séquence.

Remplacez adresses et identifiants de façon stable pour suivre le même endpoint. Ne retirez pas ports, directions ou longueurs nécessaires. Gardez la table secrète séparée. Consultez les limites de capture et d’export et le parcours PCAP Surgery.

QA avant publication

Titre et réponse traitent-ils le même flow ? Chaque durée cite-t-elle horloge et points ? La première frontière défaillante est-elle claire ? Une alternative est-elle testée ? Une seule variable change-t-elle ? L’original subsiste-t-il ? Limitez la conclusion : « Cette capture prouve le comportement côté client pendant cet intervalle, pas l’exécution interne du serveur. »

Le terme Semrush validé PCAP analyzer reste la propriété exclusive du produit. Cet article ne revendique ni volume ni KD non mesurés.

Réponse directe et limite d’acceptation

La réponse courte à « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion » est la suivante : Comment résoudre les échecs de mise à niveau de WebSocket avec les captures de paquets, y compris HTTP 101, les en-têtes de mise à niveau, les en-têtes de connexion, la suppression de proxy, TLS, les réinitialisations et les délais d'inactivité. Considérez cette phrase comme un résultat à vérifier, et non comme une promesse valable pour toute entrée, tout appareil, tout projet ou tout environnement. Un résultat complet consigne l’état initial, l’action exacte, la sortie visible et la condition qui prouve la fin de la tâche dans PCAP Surgery.

Procédure fondée sur les preuves

Commencez par un cas petit et répétable avant de modifier un projet complet. Notez version de l’application, système, identité de l’entrée ou de l’appareil, réglages pertinents et résultat attendu. Exécutez une action volontaire, conservez la première transition inattendue et comparez-la à un cas nominal si possible. Plusieurs changements simultanés masquent la condition qui a créé ou corrigé le problème.

Point de contrôle 1 : Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes

Traitez « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion » comme une porte d’acceptation distincte pour « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 2 : Comment résoudre les échecs de mise à niveau de WebSocket avec les captures de paquets, y

Transformez « Comment résoudre les échecs de mise à niveau de WebSocket avec les captures de paquets, y compris HTTP 101, les en-têtes de mise à niveau, les en-tête » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 3 : À quoi ressemble une mise à niveau saine de WebSocket

Traitez « À quoi ressemble une mise à niveau saine de WebSocket » comme une porte d’acceptation distincte pour « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 4 : Échecs de mise à niveau courants

Transformez « Échecs de mise à niveau courants » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 5 : Problèmes d'en-tête de proxy

Traitez « Problèmes d'en-tête de proxy » comme une porte d’acceptation distincte pour « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 6 : TLS et SNI

Transformez « TLS et SNI » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 7 : La connexion est interrompue après 101

Traitez « La connexion est interrompue après 101 » comme une porte d’acceptation distincte pour « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 8 : Checklist

Transformez « Checklist » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 9 : Diagnostic final

Traitez « Diagnostic final » comme une porte d’acceptation distincte pour « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions de connexion ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 10 : Réponse fondée sur les paquets pour « Analyse PCAP d'échec de mise à niveau WebSocket : 10

Transformez « Réponse fondée sur les paquets pour « Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et inter » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Matrice d’acceptation

Point	Preuve à conserver	Critère de réussite
Analyse PCAP d'échec de mise à niveau WebSocket : 101 protocoles de commutation, en-têtes de proxy, TLS et interruptions	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Comment résoudre les échecs de mise à niveau de WebSocket avec les captures de paquets, y compris HTTP 101, les en-têtes	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
À quoi ressemble une mise à niveau saine de WebSocket	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Échecs de mise à niveau courants	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Problèmes d'en-tête de proxy	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
TLS et SNI	État initial, une action et état obtenu	Une seconde personne reproduit le résultat

Isolation, reprise et transmission

Arrêtez-vous à la première limite en échec. Conservez source, projet, session ou capture, dupliquez avant toute modification destructive et changez une variable par essai. Rejouer un flux entier après plusieurs changements peut modifier le résultat sans expliquer pourquoi.

Distinguez absence de preuve et preuve d’absence. Une vue vide peut signaler mauvaise entrée, portée, filtre, permission, appareil, période ou état du projet. Vérifiez acquisition ou import avant d’interpréter décodeur, éditeur, rapport ou export.

Avant transmission, rouvrez l’artefact durable et inspectez début, point de décision et fin. Notez version, plateforme, configuration, attente, observation et reproduction minimale. Retirez ou masquez les données sensibles et confirmez l’autorisation du destinataire.

Questions et réponses

Quelle est la manière fiable la plus rapide de commencer ?

Utilisez le plus petit cas représentatif, écrivez le résultat attendu et ne changez qu’une variable. Validez le parcours de base avant d’ajouter filtres, effets, modifications, automatisation ou grande source.

Quelles preuves faut-il conserver ?

Gardez identité de l’entrée, version, plateforme, réglages, action exacte, première transition inattendue et sortie finale. Fermez puis rouvrez projet, session, rapport ou export avant de le considérer durable.

Quand faut-il répéter la procédure ?

Répétez-la après un changement pertinent d’application, système, pilote, firmware, modèle, source ou processus. Conservez le cas accepté précédent comme référence non modifiée.

Quand le résultat est-il transmissible ?

Lorsqu’une seconde personne autorisée identifie l’entrée, répète l’action, obtient le même résultat, comprend les limites et ouvre l’artefact sans état local non documenté.

Guides associés

Ces pages dans la même langue couvrent les étapes voisines sans changer le propriétaire canonique du sujet :