Como Corrigir ERR_BLOCKED_BY_CLIENT no Chrome

Você está depurando um projeto frontend quando a aba Network do DevTools do Chrome acende em vermelho. O erro exibe net::ERR_BLOCKED_BY_CLIENT. Seu script de analytics não carrega, uma fonte de terceiros falha silenciosamente ou uma requisição de API nunca é concluída. O servidor não está rejeitando sua requisição—algo na sua própria máquina está bloqueando-a.

Este guia explica o que causa o erro ERR_BLOCKED_BY_CLIENT do Chrome e apresenta etapas práticas de troubleshooting para desenvolvedores diagnosticando requisições de rede bloqueadas.

O Que ERR_BLOCKED_BY_CLIENT Realmente Significa

Diferentemente de erros do lado do servidor (404, 500), este erro de requisição bloqueada do Chrome se origina localmente. O “client” (cliente) é o seu navegador. O Chrome está dizendo: “Tentei buscar este recurso, mas algo neste dispositivo me impediu.”

A requisição nunca chega ao servidor. Em vez disso, uma extensão, política do navegador ou configuração local a intercepta e cancela antes da partida.

Esta distinção é importante. Você não encontrará respostas em logs de servidor ou infraestrutura de rede. A solução existe dentro do seu ambiente de navegação.

Causas Comuns Encontradas por Desenvolvedores

Extensões do Navegador: O Principal Culpado

Extensões com capacidades de filtragem de rede causam a maioria dos erros ERR_BLOCKED_BY_CLIENT. Estas incluem:

• Bloqueadores de anúncios (uBlock Origin, AdGuard, AdBlock)
• Ferramentas de privacidade (Privacy Badger, Ghostery)
• Extensões de segurança (bloqueadores de scripts, ferramentas anti-rastreamento)

Essas extensões mantêm listas de filtros—regras que correspondem a padrões de URL. Quando uma URL de requisição dispara um filtro, a extensão a bloqueia. Uma requisição para analytics.example.com/track.js pode corresponder a um filtro direcionado a scripts de rastreamento, mesmo que seja essencial para sua aplicação.

Manifest V3 e Mudanças nas Extensões

A mudança do Chrome para o Manifest V3 alterou como as extensões interceptam requisições. Extensões construídas na arquitetura antiga Manifest V2 podem se comportar de forma diferente ou serem completamente desabilitadas conforme o Chrome elimina gradualmente o suporte. Se você atualizou recentemente o Chrome e começou a ver requisições bloqueadas, uma extensão desatualizada perdendo funcionalidade—ou uma recém-atualizada mudando seu comportamento de bloqueio—pode ser a responsável.

Políticas Empresariais e de Navegador Gerenciado

Em ambientes corporativos, administradores de TI implementam políticas do Chrome que restringem acesso à rede. Essas políticas podem bloquear domínios específicos, tipos de recursos ou padrões de URL sem nenhuma extensão visível.

Verifique chrome://policy para ver políticas ativas. Se você está em um dispositivo gerenciado, esta é frequentemente uma fonte negligenciada de erros do tipo blocked-by-client—mesmo quando nenhuma extensão está instalada.

Falsos Positivos de Listas de Filtros

Seus recursos podem disparar bloqueios não intencionalmente. Caminhos de arquivos contendo strings como /ads/, /tracking/ ou /banner/ comumente correspondem a regras de filtro. Uma imagem legítima em /assets/ads-campaign/hero.png pode ser bloqueada puramente por causa de seu caminho.

Como Corrigir ERR_BLOCKED_BY_CLIENT

Passo 1: Testar no Modo Anônimo

Abra uma janela Anônima (Ctrl+Shift+N no Windows, Cmd+Shift+N no Mac). Por padrão, extensões não são executadas no modo Anônimo a menos que explicitamente habilitadas.

Se a requisição for bem-sucedida no modo Anônimo, uma extensão está bloqueando-a. Se ainda falhar, a causa é provavelmente uma política do navegador ou flag do Chrome.

Passo 2: Isolar a Extensão que Está Bloqueando

Para desabilitar extensões para troubleshooting do Chrome:

1. Navegue até chrome://extensions
2. Desative as extensões uma por uma
3. Recarregue sua página após cada mudança
4. Quando a requisição for bem-sucedida, você encontrou o culpado

Comece com bloqueadores de anúncios e ferramentas de privacidade—eles são os ofensores mais comuns.

Passo 3: Inspecionar o Bloqueio no DevTools

Abra o DevTools (F12), vá para a aba Network e recarregue. Requisições que falharam mostram o erro na coluna Status. Clique na requisição para ver detalhes.

Algumas extensões (como uBlock Origin) adicionam seus próprios painéis no DevTools mostrando exatamente qual regra de filtro disparou o bloqueio. Isso ajuda você a entender se deve adicionar o domínio à lista de permissões ou renomear seu recurso.

Passo 4: Verificar Políticas do Navegador

Visite chrome://policy para visualizar quaisquer restrições ativas. Em dispositivos gerenciados, políticas como URLBlocklist podem bloquear requisições silenciosamente. Se as políticas são o problema, contate seu administrador de TI.

Passo 5: Testar em um Perfil Limpo

Crie um perfil novo do Chrome sem extensões ou personalizações:

1. Clique no ícone do seu perfil no Chrome
2. Selecione “Adicionar” para criar um novo perfil
3. Teste sua aplicação neste ambiente limpo

Isso elimina configurações em cache, dados corrompidos e todas as extensões simultaneamente.

Passo 6: Revisar a Nomenclatura dos Seus Recursos

Se você controla o recurso bloqueado, verifique o caminho da URL. Renomeie arquivos ou diretórios que contenham gatilhos comuns de listas de filtros (/ad/, /tracking/, /banner/, /sponsor/). Isso previne falsos positivos nos navegadores dos seus usuários.

Quando o Erro Persiste

Se nenhum desses passos resolver o problema, considere:

• Resetar as flags do Chrome em chrome://flags (clique em “Reset all”)
• Limpar cache e cookies do navegador
• Verificar se o software antivírus inclui recursos de filtragem web

Conclusão

O erro ERR_BLOCKED_BY_CLIENT significa que seu navegador—não o servidor—está impedindo uma requisição. Extensões são geralmente responsáveis, mas políticas gerenciadas e falsos positivos de listas de filtros também causam problemas. Isolamento sistemático usando modo Anônimo, alternância de extensões e perfis limpos identificarão a origem. Para desenvolvedores, entender este erro previne horas de depuração no lugar errado.

Perguntas Frequentes

Gain control over your UX

See how users are using your site as if you were sitting next to them, learn and iterate faster with OpenReplay. — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.