
O Chrome mostra uma página cinzenta com um título, uma frase e um código:
A ligação foi interrompida
Foi detetada uma alteração de rede.
ERR_NETWORK_CHANGED
Num Chrome em inglês, o mesmo ecrã diz “Your connection was interrupted” / “A network change was detected.”. No Chrome em português do Brasil diz “A conexão foi interrompida” / “Foi detectada uma alteração na rede.”, que é a formulação que os leitores brasileiros costumam pesquisar.
A descrição que o Chromium dá desse código, no ficheiro onde estão definidos todos os erros de rede do Chrome, tem três palavras em inglês: “The network changed.” (A rede mudou.) É o erro número -21, e não tem nada a ver com o site que estava a visitar. Tem a ver com a máquina em que estava sentado.
O que significa, em palavras simples
Enquanto a página carregava, o computador ou o telemóvel mudou a rede que estava a usar, ou o seu endereço nessa rede, e o Chrome descartou as ligações que estava a construir sobre a antiga. Não há nada de errado com o site, e nada do que escreveu causou isto.
As causas habituais são banais: mudou entre duas redes Wi-Fi, uma VPN ligou-se, desligou-se ou voltou a ligar-se, um portátil foi ligado a uma estação de ancoragem ou um cabo foi ligado, ou um telemóvel passou do Wi-Fi para os dados móveis. Qualquer uma destas situações pode dar ao dispositivo um endereço novo, e uma mudança de endereço a meio do carregamento de uma página é exatamente o que este erro reporta.
O que normalmente se deve fazer é apenas recarregar, e muitas vezes o Chrome faz isso por si antes de lhe dar oportunidade (mais sobre isso adiante). Se estava a submeter algo, uma encomenda, um pagamento ou uma mensagem, verifique se chegou antes de tentar de novo.
O que conta como uma mudança de rede
O Chrome fica a saber disto através de um componente chamado network change notifier, e o contrato do sinal que aqui interessa está escrito no código-fonte: o sinal dispara “when the IP address of the primary interface changes. This includes when the primary interface itself changes.” (quando o endereço IP da interface principal muda. Isto inclui quando a própria interface principal muda.)
Assim, duas coisas diferentes produzem o mesmo erro. O seu endereço na mesma rede pode mudar, e o dispositivo pode trocar a rede que considera principal. Um cliente VPN é o exemplo habitual do segundo caso: quando se liga, o túnel passa a ser o caminho de saída, e do ponto de vista do Chrome a rede mudou, mesmo que o Wi-Fi nunca tenha caído.
Algo que antes contava, mas que no código-fonte atual já não conta: muitos sistemas renovam os seus endereços IPv6 temporários com regularidade, por privacidade, e o código passa agora ao lado desse tipo de mudança ao decidir se deve largar ligações, por trás de um interruptor de funcionalidade que vem ativado por predefinição.
O que o Chrome faz nesse momento
É esta parte que decide o que a pessoa diante do ecrã perde de facto.
Nas ligações normais, o pool de sockets do Chrome executa uma rotina chamada FlushWithError com este
erro. Cancela todas as ligações que ainda estavam a ser estabelecidas, falha todos os pedidos que esperavam
por uma delas, fecha as ligações inativas que guardava para reutilização e marca as restantes para que não
voltem a ser atribuídas.
HTTP/2 depende da plataforma. No Windows, Android e iOS, o Chrome marca as sessões existentes como prestes
a terminar em vez de as fechar, e o comentário no código explica porquê: nos sistemas que, de qualquer
modo, repõem as ligações TCP depois de uma mudança de rede, isto é uma tentativa de deixar terminar os
pedidos ativos, embora “streams may still fail due to a generated TCP reset” (os fluxos podem continuar a
falhar devido a um reset TCP gerado). Nos restantes sistemas, incluindo macOS e Linux, as sessões são
fechadas com ERR_NETWORK_CHANGED.
HTTP/3 é diferente outra vez. Funciona sobre QUIC, que consegue mover uma ligação de uma rede para outra, e onde essa migração está ativada o Chrome deixa as sessões em paz em vez de as interromper.
Na prática: um pedido que ainda não tinha ligação falha sempre. Um pedido já em curso pode concluir-se, pode falhar, e do lado de fora não se consegue saber qual dos dois.
Porque é que a página de erro muitas vezes desaparece sozinha
O Chrome tem um recarregamento automático para as páginas de erro causadas pela conectividade, e este erro está incluído. Depois de um carregamento falhado, volta a tentar com intervalos crescentes: um segundo, depois cinco, trinta, um minuto, cinco minutos, dez, trinta. Só o faz enquanto o separador está visível e o dispositivo considera que está online.
Duas exceções nesse código merecem ser conhecidas. Nunca recarrega uma página que resultou do envio de um
formulário (um POST), por isso quem mudou de rede enquanto carregava em “Pagar” fica na página de erro, e
essa é a decisão certa. E fica totalmente desligado quando o Chrome é iniciado com --enable-automation, a
opção que as ferramentas de teste usam para controlar o navegador. Um utilizador vê o erro piscar e
desaparecer; um teste automatizado vê-o ficar.
É por isso que o relatório de erro diz “apareceu um erro durante um segundo e depois carregou”, ou porque não há relatório nenhum.
Session Replay
Extensão gratuita do Chrome. Um clique na página que se está a portar mal captura a captura de ecrã, a consola e o registo de rede, e devolve-lhe um link para colar no ticket.
Como parece do lado da página
A página de erro é o que acontece a uma navegação. Os pedidos que a própria página faz, através de
fetch ou XMLHttpRequest, não recebem nem página nem recarregamento. São rejeitados como qualquer falha
de rede, o que no Chrome se traduz em
TypeError: Failed to fetch,
e o seu sistema de registo de erros regista isso como mais uma ocorrência do erro menos informativo que
existe.
O seu servidor, entretanto, não tem nada a mostrar para os pedidos que nunca chegaram a obter uma ligação, e talvez uma linha de registo perfeitamente normal para um pedido que se concluiu pouco antes de a resposta se perder. Se os seus erros se concentram em portáteis de manhã ou em telemóveis nas horas de deslocação, esta é uma pista forte: são esses os momentos em que os dispositivos mudam de rede.
E para tudo o que escreve, o comportamento honesto é o mesmo de qualquer pedido interrompido: assuma que pode ter chegado, e torne a nova tentativa segura em vez de contar com que o utilizador tenha cuidado.
Quando acontece repetidamente
Uma vez é uma mudança de rede. De poucos em poucos minutos significa que algo no dispositivo está a mudar repetidamente a interface principal ou o respetivo endereço: uma VPN que não para de religar, uma ligação Wi-Fi que cai e volta a entrar, ou duas redes que se revezam como predefinida.
O Chrome consegue mostrar-lhe qual é. Grave um registo em chrome://net-export enquanto acontece, e ele
contém um evento, NETWORK_IP_ADDRESSES_CHANGED, que o Chromium descreve como emitido “whenever
NetworkChangeNotifier determines that an active network adapter’s IP address has changed” (sempre que o
NetworkChangeNotifier determina que o endereço IP de um adaptador de rede ativo mudou). Os momentos desses
eventos comparados com as horas dos erros mostram se o dispositivo é a causa.
É a mesma pergunta que distinguir o seu bug de uma avaria alheia, com a diferença de que a avaria está na máquina do próprio utilizador. É uma falha diferente da família ERR_CONNECTION, em que um servidor ou algo no caminho recusou ou cortou a ligação.
O que pôr no relatório
Se foi você quem viu, estes elementos tornam o relatório útil:
- A hora exata, para poder ser cruzada com qualquer outra coisa.
- Se estava numa VPN, se tinha acabado de mudar de sítio, se ligou ou desligou o portátil da estação de ancoragem, ou se trocou entre Wi-Fi e dados móveis.
- Se a página voltou sozinha, ou se ficou no erro.
- O que tinha acabado de fazer, sobretudo se submeteu um formulário ou um pagamento.
Se é você quem o recebe: o erro descreve o dispositivo do utilizador, não o seu site, e a única coisa que vale a pena verificar do seu lado é se algo do que ele submeteu chegou duas vezes, ou não chegou de todo.