Chrome mostra una pagina grigia con un titolo, una frase e un codice:

La connessione è stata interrotta

È stato rilevato un cambio di rete.

ERR_NETWORK_CHANGED

In un Chrome in inglese la stessa schermata dice “Your connection was interrupted” / “A network change was detected.”

La descrizione che Chromium dà di quel codice, nel file in cui sono definiti tutti gli errori di rete di Chrome, è lunga tre parole in inglese: “The network changed.” (La rete è cambiata.) Il codice è il numero -21, e non riguarda affatto il sito che stavi visitando. Riguarda il dispositivo che avevi davanti.

Cosa significa, in parole semplici

Mentre la pagina si caricava, il computer o il telefono ha cambiato la rete che stava usando, oppure il proprio indirizzo su quella rete, e Chrome ha scartato le connessioni che stava costruendo su quella vecchia. Con il sito non c’è niente che non va, e niente di quello che hai digitato lo ha causato.

I motivi più comuni sono ordinari: ti sei spostato tra due reti Wi-Fi, una VPN si è connessa, disconnessa o riconnessa, un portatile è stato collegato alla stazione di aggancio o è stato inserito un cavo, oppure un telefono è passato dal Wi-Fi ai dati mobili. Ciascuna di queste situazioni può dare al dispositivo un nuovo indirizzo, e un cambio di indirizzo a metà del caricamento di una pagina è esattamente ciò che questo errore segnala.

Di solito basta ricaricare la pagina, e spesso Chrome lo fa per te prima che tu possa farlo (più avanti ne parliamo). Se stavi inviando qualcosa, un ordine, un pagamento o un messaggio, controlla se è arrivato prima di riprovare.

Cosa conta come cambio di rete

Chrome lo viene a sapere da un componente chiamato network change notifier, e il contratto del segnale che qui conta è scritto nel suo codice sorgente: il segnale scatta “when the IP address of the primary interface changes. This includes when the primary interface itself changes.” (quando cambia l’indirizzo IP dell’interfaccia principale. Questo include anche il caso in cui cambia l’interfaccia principale stessa.)

Quindi due cose diverse producono lo stesso errore. Il tuo indirizzo sulla stessa rete può cambiare, e il dispositivo può passare a considerare un’altra rete come principale. Il client VPN è l’esempio tipico del secondo caso: quando si connette, il tunnel diventa la strada verso l’esterno, e dal punto di vista di Chrome la rete è cambiata anche se il Wi-Fi non è mai caduto.

Una cosa che un tempo contava, ma nel codice attuale non conta più: molti sistemi cambiano nel tempo i propri indirizzi IPv6 temporanei, per motivi di privacy, e il codice ora ignora questo tipo di cambio quando decide se chiudere le connessioni, dietro un interruttore di funzionalità attivo di default.

Cosa fa Chrome in quel momento

Questa è la parte che decide che cosa perde davvero la persona davanti allo schermo.

Per le connessioni ordinarie, il pool di socket di Chrome esegue una routine chiamata FlushWithError con questo errore. Annulla ogni connessione ancora in fase di apertura, fa fallire ogni richiesta che aspettava una connessione, chiude le connessioni inattive che teneva per riutilizzarle e contrassegna le altre perché non vengano più assegnate.

HTTP/2 dipende dalla piattaforma. Su Windows, Android e iOS, Chrome contrassegna le sessioni esistenti come in chiusura invece di chiuderle, e il commento nel codice spiega perché: sui sistemi che comunque reimpostano le connessioni TCP dopo un cambio di rete, questo è un tentativo di far terminare le richieste attive, anche se “streams may still fail due to a generated TCP reset” (i flussi possono comunque fallire a causa di un reset TCP generato). Altrove, compresi macOS e Linux, le sessioni vengono chiuse con ERR_NETWORK_CHANGED.

HTTP/3 è diverso ancora. Usa QUIC, che può spostare una connessione da una rete all’altra, e dove questa migrazione è attiva Chrome lascia le sessioni in pace invece di interromperle.

In pratica: una richiesta che non aveva ancora ottenuto una connessione fallisce sempre. Una richiesta già in corso potrebbe completarsi, potrebbe fallire, e dall’esterno non si può dire quale dei due accadrà.

Perché la pagina d’errore spesso scompare da sola

Chrome ha un ricaricamento automatico per le pagine d’errore dovute alla connettività, e questo errore rientra tra quelle. Dopo un caricamento fallito riprova a intervalli crescenti: un secondo, poi cinque, trenta, un minuto, cinque minuti, dieci, trenta. Lo fa solo mentre la scheda è visibile e il dispositivo ritiene di essere online.

Nel codice ci sono due eccezioni che vale la pena conoscere. Non ricarica mai una pagina che è il risultato dell’invio di un modulo (una POST), quindi chi ha cambiato rete mentre premeva “Paga” resta sulla pagina d’errore, ed è la scelta giusta. E il ricaricamento è disattivato del tutto quando Chrome viene avviato con --enable-automation, il flag che gli strumenti di test usano per pilotare il browser. Un utente vede l’errore comparire per un attimo e sparire; un test automatico lo vede restare.

È questo lampo a spiegare perché la segnalazione dice “è apparso un errore per un secondo e poi la pagina si è caricata”, o perché una segnalazione non arriva affatto.

Session Replay

Estensione gratuita per Chrome. Un clic sulla pagina che si comporta male cattura lo screenshot, la console e il registro di rete, e ti restituisce un link da incollare nel ticket.

Installa l'estensione

Cosa succede dal lato della pagina

La pagina d’errore è ciò che succede a una navigazione. Le richieste che la pagina fa da sola, tramite fetch o XMLHttpRequest, non ottengono né una pagina né un ricaricamento. Vengono rifiutate come qualunque errore di rete, che in Chrome si presenta come TypeError: Failed to fetch, e il tuo strumento di monitoraggio degli errori lo registra come un’altra occorrenza dell’errore meno informativo che esista.

Il tuo server, intanto, non ha niente da mostrare per le richieste che non hanno mai ottenuto una connessione, e forse una riga di log perfettamente normale per una richiesta completata poco prima che la sua risposta andasse persa. Se i tuoi errori si concentrano sui portatili al mattino o sui telefoni negli orari di punta, questa è una pista forte: sono i momenti in cui i dispositivi cambiano rete.

E per tutto ciò che scrive, il comportamento corretto è lo stesso di qualsiasi richiesta interrotta: dai per scontato che possa essere arrivata, e rendi sicuro il nuovo tentativo invece di affidarti a un utente attento.

Quando succede di continuo

Una volta sola è un cambio di rete. Ogni pochi minuti significa che qualcosa sul dispositivo cambia di continuo l’interfaccia principale o il suo indirizzo: una VPN che non smette di riconnettersi, una connessione Wi-Fi che cade e torna di continuo, oppure due reti che si alternano nel ruolo di predefinita.

Chrome può mostrarti quale dei casi è. Registra un log su chrome://net-export mentre succede, e conterrà un evento, NETWORK_IP_ADDRESSES_CHANGED, che Chromium descrive come emesso “whenever NetworkChangeNotifier determines that an active network adapter’s IP address has changed” (ogni volta che NetworkChangeNotifier stabilisce che l’indirizzo IP di una scheda di rete attiva è cambiato). Confrontando gli orari di quegli eventi con quelli degli errori si capisce se è il dispositivo la causa.

È la stessa domanda di distinguere il proprio bug da un guasto altrui, con la differenza che qui il guasto è nel computer dell’utente. È un problema diverso dalla famiglia ERR_CONNECTION, in cui un server o qualcosa lungo il percorso ha rifiutato o interrotto la connessione.

Cosa inserire nella segnalazione

Se sei tu quello che l’ha visto, questi elementi rendono la segnalazione utile:

  • L’orario esatto, così può essere confrontato con qualsiasi altra cosa.
  • Se eri su una VPN, se ti eri appena spostato, se avevi collegato o scollegato il portatile, oppure se eri passato dal Wi-Fi ai dati mobili.
  • Se la pagina è tornata da sola, oppure è rimasta sull’errore.
  • Cosa avevi appena fatto, soprattutto se avevi inviato un modulo o un pagamento.

Se invece la ricevi tu: l’errore descrive il dispositivo dell’utente, non il tuo sito, e l’unica cosa che vale la pena controllare dal tuo lato è se qualcosa di quello che ha inviato è arrivato due volte, o non è arrivato affatto.