Como corrigir o erro ERR_UNKNOWN_URL_SCHEME (9 soluções rápidas)

Principais conclusões

• O erro ERR_UNKNOWN_URL_SCHEME aparece quando um link usa um esquema de URL não suportado ou malformado.
• A maioria dos casos é resolvida através de passos simples no browser, como limpar a cache ou desativar extensões.
• O Android WebView precisa de um tratamento explícito para esquemas não HTTP/HTTPS para evitar falhas.
• As regras de redireccionamento estáveis e a formatação limpa do URL ajudam a evitar este erro em todos os ambientes.

As hiperligações têm diferentes finalidades na Internet. Algumas abrem páginas. Algumas iniciam e-mails. Outras iniciam uma aplicação no dispositivo. Quando o browser não consegue interpretar o tipo de ligação que recebe, pára e mostra net::err_unknown_url_scheme.

O erro pode aparecer num site normal ou dentro de uma aplicação que carrega conteúdo da Web. Um passo de início de sessão pode ser interrompido. Um redireccionamento pode falhar. Um WebView numa aplicação Android pode congelar antes de a página aparecer. Cada exemplo aponta para a mesma ideia. A ligação utiliza um formato que o browser não suporta.

As equipas deparam-se frequentemente com este problema quando testam redireccionamentos ou ligações profundas. Os utilizadores vêem-no durante a navegação de rotina. O padrão parece diferente em cada caso, mas a causa é consistente. O browser chega a um esquema que não consegue gerir, pelo que bloqueia o pedido no primeiro passo.

O guia explica porque é que o browser pára nesse ponto e o que podes fazer a seguir. Em seguida, passa às correcções práticas para os navegadores e às correcções técnicas para o Android WebView.

O papel dos esquemas de URL é a base para compreender o erro, e cada secção baseia-se nessa ideia para te ajudar a resolvê-lo ou evitá-lo.

~ O Chrome apresenta a mensagem net::ERR_UNKNOWN_URL_SCHEME quando encontra um esquema de URL não suportado.

O que é o erro net::err_unknown_url_scheme?

O erro net::err_unknown_url_scheme aparece quando um browser encontra uma ligação que começa com um esquema que não reconhece.

Cada URL começa com uma diretiva que indica ao browser como tratar o pedido. Quando a diretiva está fora da lista suportada, o browser pára antes de carregar qualquer página ou script.

O erro assinala um ponto simples. A instrução no início da ligação não pode ser associada a uma ação permitida. Não envia nenhuma chamada de rede para o servidor. Não executa nenhuma lógica de aplicação. O pedido termina no momento em que o esquema falha.

A compreensão desta primeira etapa explica por que o erro aparece em navegadores, redirecionamentos e ambientes WebView incorporados. A secção seguinte analisa os factores comuns que estão na origem dessa falha.

Experimenta menos erros de hospedagem com o Cloudways Autonomous

O Cloudways Autonomous usa o dimensionamento automático baseado em Kubernetes e a infraestrutura gerenciada para reduzir problemas de configuração, lidar com picos de tráfego automaticamente e manter seu site estável e responsivo.

Experimenta hoje

Causas do erro Net::Err_Unknown_Url_Scheme

O erro surge quando algo interfere com a parte de abertura de um URL. O browser avalia esse primeiro passo antes de qualquer outra coisa, pelo que qualquer perturbação nesta fase interrompe o pedido. Quando essa instrução de abertura se torna pouco clara ou não é suportada, o pedido pára.

1. Uma ligação começa com um esquema que o browser não suporta

Algumas ligações utilizam diretivas fora do conjunto permitido. Quando o browser não consegue classificar a diretiva, o pedido termina na verificação do esquema.

2. Um Redireccionamento Introduz um Esquema Diferente

Uma cadeia de redireccionamento pode modificar o URL. Um serviço no caminho pode retornar um link que começa com um novo padrão. Quando o browser atinge esse padrão, o processo pára.

3. Um prefixo malformado causado por uma gralha ou um erro de formatação

A falta de dois pontos ou um prefixo alterado altera a forma como o URL é analisado. O browser trata o texto modificado como um esquema separado e desconhecido.

4. Extensões do navegador que reescrevem ou filtram ligações

As extensões podem acrescentar parâmetros ou remover partes de um URL. Uma alteração ao nível da diretiva transforma a ligação em algo que o browser não consegue interpretar.

5. Cookies corrompidos ou dados de encaminhamento armazenados em cache

Os dados de redireccionamento antigos podem apontar o browser para um caminho desatualizado. Se esse caminho começar com uma diretiva não suportada, o pedido falha.

6. Conflitos de renderização com aceleração de hardware

As camadas de GPU podem falhar durante o processamento de transições orientadas por ligações. Quando o browser detecta a falha, bloqueia o pedido antes de carregar a página.

7. Firewall ou software de segurança a bloquear a ação

Os filtros locais podem restringir as ligações que iniciam funções ao nível do dispositivo. O browser pára o pedido quando a ação não é permitida.

8. WebView sem um manipulador para uma ação necessária

A WebView carrega páginas mas não gere tarefas externas por si só. Quando uma ligação requer um manipulador não definido no código, a vista pára nesse ponto.

Bootcamp de desempenho da Cloudways – Gratuito – 10 e 11 de março

Do CDN ao Core Web Vitals – vê os especialistas a resolver problemas reais de desempenho do WordPress, em direto.

Regista-te agora →

Estas condições descrevem os principais pontos em que o pedido pode falhar. A próxima secção cobre os passos do lado do browser que abordam estes pontos em termos práticos.

Como corrigir o erro Net::Err_Unknown_Url_Scheme (9 métodos fáceis)

Os navegadores bloqueiam a solicitação quando uma regra local, um valor armazenado em cache ou uma extensão altera a forma como o link é interpretado. Trabalhar com os ajustes abaixo ajuda a reduzir a causa e a restaurar o comportamento esperado.

1. Desativar as extensões

As extensões reescrevem frequentemente URLs ou filtram acções. Se as desactivares, o browser terá um ponto de partida limpo.

Avança:

1. Abre o Chrome.
2. Vai a chrome://extensions/.
3. Desliga todas as extensões.
4. Actualiza a página e tenta novamente a ligação.

2. Limpa os cookies e os dados armazenados em cache

Os dados de encaminhamento antigos podem enviar o navegador para caminhos desactualizados. Limpar ficheiros armazenados redefine a forma como o Chrome interpreta as hiperligações.

Avança:

1. Abre o Chrome e vai a Definições.
2. Seleciona Privacidade e segurança.
3. Clica em Eliminar dados de navegação.
4. Verifica os cookies e os ficheiros em cache.
5. Clica em Limpar dados e, em seguida, recarrega a página.

3. Desliga a aceleração gráfica

A renderização da GPU pode falhar durante determinadas transições. Desativar a aceleração gráfica remove essa camada do processo.

Avança:

1. Abre as Definições do Chrome.
2. Vai para Sistema.
3. Desativa a opção Usar aceleração gráfica quando disponível.
4. Reinicia o browser.

4. Testa sem a Firewall

Algumas firewalls bloqueiam ligações que desencadeiam acções ao nível do dispositivo. Um pequeno teste revela se uma regra local interrompe a solicitação.

Avança:

• Abre as definições da firewall do teu sistema.

• Desliga temporariamente a firewall.
• Tenta novamente a ligação no Chrome.
• Volta a ligar a firewall imediatamente após o teste.

5. Cria um novo perfil de navegador

Os perfis armazenam preferências, extensões e regras de encaminhamento em cache. Um novo perfil remove as alterações herdadas.

Avança:

• Abre o Chrome.
• Clica no ícone do teu perfil (canto superior direito).
• Seleciona Adicionar perfil do Chrome.

• Cria um perfil novo e limpo.
• Abre novamente a ligação no novo perfil.

6. Abre a ligação numa nova janela

Alguns browsers avaliam a ligação de forma diferente quando o contexto muda.

Avança:

1. Clica com o botão direito do rato na ligação.
2. Seleciona Abrir a ligação num novo separador ou Abrir a ligação numa nova janela.
3. Verifica se o Chrome processa o esquema corretamente.

7. Experimenta um browser que não seja de crómio

Motores diferentes interpretam esquemas de URL de formas diferentes. Testar fora do Chromium ajuda a confirmar se o problema é específico do navegador.

Avança:

1. Abre outro browser (Firefox, Safari, etc.).
2. Cola a mesma ligação.
3. Compara a forma como o segundo browser lida com o esquema.

8. Repor os sinalizadores do navegador

Os sinalizadores experimentais podem afetar a navegação, a renderização ou o tratamento de esquemas. Redefini-los remove o comportamento não intencional.

Avança:

1. Abre o Chrome.
2. Vai a chrome://flags/.
3. Clica em Repor tudo (canto superior direito).
4. Reinicia o browser.

9. Actualiza o Browser para a versão mais recente

As versões mais antigas podem conter erros de análise ou regras de esquema desactualizadas. A atualização garante que é aplicada a lógica de tratamento mais recente.

Avança:

1. Abre as Definições do Chrome.
2. Vai a Acerca do Chrome.
3. O Chrome verifica automaticamente se existem actualizações.
4. Aplica as actualizações e, em seguida, reinicia o browser.
5. Volta a tentar a ligação.

Estes ajustes resolvem muitas falhas do lado do utilizador. A próxima secção abrange correcções ao nível do programador para WebView e ambientes de aplicações incorporadas, onde os esquemas não suportados requerem um tratamento explícito.

Correcções do programador para o erro Net::Err_Unknown_Url_Scheme

A WebView lida com páginas Web normais sem problemas. Os problemas surgem quando uma ligação desencadeia uma ação fora da vista.

Um pedido que deve abrir outra aplicação, iniciar uma função do dispositivo ou seguir uma diretiva personalizada precisa de um tratamento claro no código. Estes ajustes ajudam o WebView a processar esses caminhos e a reduzir as falhas net::err_unknown_url_scheme em ambientes Android.

Começa com o método de substituição de URL, que o WebView chama antes de carregar uma ligação. Isto dá-te um ponto para inspecionar o esquema e decidir como o pedido se deve mover. Os esquemas padrão permanecem dentro da visualização. Qualquer outra coisa precisa de um caminho explícito.

#1 Trata de esquemas que a vista não pode processar

Verifica o URL dentro do método de substituição. Identifica o esquema. Decide se a ação pertence à visualização ou a outra aplicação. Isto clarifica o percurso e evita que o WebView adivinhe o passo seguinte.

#2 Utilizar intenções para acções que abrem aplicações externas

As ligações que iniciam o correio eletrónico, os mapas ou as mensagens não podem ser executadas no WebView. Passa essas acções para uma intenção. Se a aplicação necessária estiver em falta, apresenta uma pequena mensagem em vez de deixar a vista em branco.

Exemplo de código:

@Override

public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {

Uri uri = request.getUrl();




String scheme = uri.getScheme();

Se ("http".equals(scheme) || "https".equals(scheme)) {

return false; // Carrega dentro da WebView

}




tenta {

Intent intent = new Intent(Intent.ACTION_VIEW, uri);

view.getContext().startActivity(intent);

} catch (Exception e) {

// Aplicação não instalada

}




retorna verdadeiro;

}

#3 Restringe a visualização quando não são necessárias acções externas

Algumas aplicações apenas apresentam conteúdos Web. Nesses casos, aceita apenas http e https. Bloqueia tudo o resto e redirecciona o utilizador para um ponto estável na interface.

#4 Faz corresponder o método de substituição ao nível da API do dispositivo

As versões mais antigas do Android utilizam o método de substituição baseado em cadeia de caracteres. As versões mais recentes passam um objeto de pedido. A utilização da versão errada causa um comportamento inconsistente nos dispositivos. Confirma o nível de API pretendido e escolhe a assinatura correta.

#5 Valida os URLs antes de os passar para a vista

As ligações podem ser provenientes de APIs, dados armazenados ou entradas do utilizador. Um prefixo malformado causará uma falha imediata. Valida cada URL antes de o carregar.

#6 Adiciona um comportamento de recurso para acções não suportadas

Alguns esquemas pertencem a caraterísticas que não apoias. Dá uma resposta controlada. Redirecciona o utilizador para uma localização segura ou mostra um pequeno aviso. Isto evita paragens silenciosas no fluxo de trabalho.

Estes ajustes dão ao WebView regras de encaminhamento claras e reduzem o comportamento inesperado entre dispositivos.

A próxima secção aborda técnicas de depuração mais profundas que ajudam a expor problemas não visíveis durante os testes básicos.

Passos avançados de depuração que os programadores muitas vezes ignoram

Alguns problemas só aparecem quando a ligação passa por redireccionamentos reais ou ambientes de dispositivos mistos. Estas verificações ajudam a descobrir problemas que não aparecem durante os testes básicos e muitas vezes explicam porque net::err_unknown_url_scheme aparece de forma inconsistente entre os utilizadores.

Começa por seguir a evolução da ligação. Uma cadeia de redireccionamento pode alterar o prefixo. Um retorno de chamada pode retornar um padrão personalizado. Um serviço na cadeia pode formatar o URL de forma diferente para dispositivos móveis. Seguindo a cadeia, revela qual camada altera o esquema.

Verifica a versão do Android System WebView

As diferentes versões do WebView tratam os esquemas de formas diferentes. Um dispositivo pode utilizar o pacote WebView autónomo. Outro pode depender de uma versão apoiada pelo Chrome. Confirma a versão do WebView nos dispositivos de teste para identificar um comportamento incompatível.

Inspeciona as entradas de manifesto e os filtros de intenção

Algumas acções requerem filtros explícitos no manifesto. As entradas em falta ou mal configuradas impedem o Android de encaminhar a ligação corretamente.

Verifica as actividades exportadas e confirma se os filtros de intenção correspondem aos esquemas que esperas apoiar.

Regista o URL completo antes de o WebView o carregar

Uma ligação pode parecer correta na interface mas conter alterações ocultas. Regista o URL no método de substituição e compara-o com o original. As diferenças no prefixo ou na formatação revelam o ponto de falha.

Rastreia redireccionamentos de backend em fluxos de trabalho alojados

Um servidor pode enviar uma ligação limpa. Um serviço de terceiros pode não o fazer. Inspecciona cada passo de redireccionamento, especialmente nos fluxos de início de sessão ou de pagamento. Alguns retornos de chamada introduzem prefixos personalizados que as visualizações baseadas no Chromium não reconhecem.

Valida a ligação final fora da aplicação

Abre o URL final num browser autónomo. Se o browser parar antes do tempo, o problema está na própria ligação. Se o browser carregar a página mas o WebView falhar, o problema está no tratamento ao nível da aplicação.

Testa em ambientes mistos

Alguns dispositivos tratam os esquemas de forma diferente, dependendo da implementação do WebView ou da versão do sistema. Os testes num único dispositivo podem ocultar inconsistências ao nível da API. Utiliza pelo menos duas versões do Android para identificar diferenças ambientais.

Estes passos expõem questões subtis que os testes de rotina não detectam. Assim que o comportamento subjacente se torna claro, o foco seguinte é a prevenção.

A secção seguinte descreve padrões que ajudam a evitar esquemas não suportados em primeiro lugar.

Evita erros de esquema de URL com o Cloudways WordPress Hosting

A hospedagem gerenciada do WordPress da Cloudways garante configurações de servidor estáveis, manipulação adequada de PHP e ambientes confiáveis para manter seu site livre de erros.

TESTE AGORA

Práticas recomendadas para evitar o erro Net::Err_Unknown_Url_Scheme

A prevenção do net::err_unknown_url_scheme começa com um comportamento previsível da ligação. Quando o esquema permanece consistente em redireccionamentos, vistas incorporadas e dispositivos, o fluxo de trabalho permanece estável. Os padrões abaixo ajudam a reduzir as diretivas não suportadas antes de entrarem no caminho.

Utiliza regras claras para esquemas aceitáveis. Um conjunto restrito de prefixos permitidos mantém o comportamento da aplicação previsível. O conteúdo padrão deve basear-se em http e https. Qualquer ligação que accione uma função de dispositivo deve ser deliberada, documentada e encaminhada através do código.

Valida as ligações antes de o utilizador chegar a elas. Muitos links vêm de APIs ou dados armazenados. Um passo de validação remove precocemente prefixos malformados e evita que o WebView ou o browser cheguem a instruções não suportadas.

Encaminha as acções externas através de manipuladores conhecidos. As ligações que abrem correio eletrónico, mapas ou mensagens devem passar por um caminho controlado. Um manipulador ou intenção clarifica a ação e elimina as suposições no WebView.

Monitora o comportamento de redirecionamento em fluxos que dependem de retornos de chamada. Uma rota de login ou pagamento pode envolver vários serviços. Cada salto pode introduzir um novo prefixo. Rastreia o fluxo periodicamente para garantir que o URL final retorna com um esquema suportado.

Mantém os ambientes consistentes entre o desenvolvimento, a preparação e a produção. Diferentes versões do WebView ou actualizações do browser podem alterar a forma como os esquemas são interpretados. Testar uma pequena variedade de ambientes expõe as alterações antes de chegarem aos utilizadores.

Assegura que os redireccionamentos de backend permanecem estáveis. Uma resposta do servidor que reescreve os prefixos aumenta a possibilidade de esquemas não suportados. Regras de redirecionamento limpas reduzem essas inconsistências.

As equipes que hospedam aplicativos no Cloudways podem reforçar isso mantendo a lógica de roteamento consistente em todos os ambientes. Um caminho de implementação estável reduz mudanças inesperadas sob carga.

Estas práticas ajudam a manter um comportamento previsível entre browsers, dispositivos e vistas incorporadas. Alguns pontos de referência rápida abaixo facilitam a identificação de padrões comuns ao rever as hiperligações.

Pontos de referência úteis

• Esquemas permitidos:
  • http
  • https
• Esquemas comuns não suportados:
  • mailto
  • tel
  • intenção
  • Prefixos personalizados

Estas práticas criam um fluxo de trabalho previsível e reduzem os esquemas não suportados antes de interromperem o utilizador ou a WebView.

Quando contactar o programador

Alguns casos não se enquadram na rotina de resolução de problemas. Envolvem o comportamento da ligação controlado pela própria aplicação ou por um serviço na cadeia de redireccionamento. Quando o problema vem do código ou do roteamento externo, um desenvolvedor precisa revisar o fluxo.

Contacta o programador quando a ligação tem origem dentro da aplicação. Uma ligação incorporada na interface pode utilizar um esquema que requer um controlador. Se a vista congelar ou parar, o manipulador está em falta ou incompleto.

Procura quando um serviço de terceiros controla parte do redireccionamento. Um fornecedor de início de sessão, gateway de pagamento ou API externa pode devolver um esquema que o browser não consegue interpretar. Apenas o proprietário do serviço pode ajustar essa resposta.

Pede ajuda quando a aplicação depende de acções personalizadas. Algumas aplicações accionam tarefas ao nível do dispositivo utilizando os seus próprios padrões. Estes padrões devem ser documentados e suportados no código. Os esquemas não suportados requerem uma alteração do código, não um ajuste do browser.

Solicita uma revisão quando a formatação do link muda entre ambientes. Um link pode funcionar no ambiente de teste, mas falhar na produção. Isso geralmente indica uma regra de reescrita ou redirecionamento do lado do servidor. O desenvolvedor pode rastrear a regra e restaurar o comportamento esperado.

Nestas situações, as correcções do lado do utilizador não resolverão o problema. O comportamento da ligação depende do código, da configuração ou de serviços externos. Um programador pode identificar a origem e aplicar as alterações necessárias.

Considerações finais

O erro net::err_unknown_url_scheme surge quando um browser ou WebView não consegue fazer corresponder uma ligação a uma ação suportada. A solicitação termina nessa primeira etapa, antes que qualquer lógica de servidor apareça. Encontrar onde a diretiva se desloca dá-te um ponto de partida claro para a correção.

Os ajustes do navegador tratam de causas locais. Os manipuladores ao nível da aplicação gerem as acções externas. Os redireccionamentos estáveis mantêm o fluxo previsível entre ambientes. Cada camada suporta a seguinte, e o erro torna-se raro quando o caminho de encaminhamento é consistente.

Um fluxo de trabalho que trate os esquemas com cuidado evita quebras inesperadas. Quando o caminho da ligação se mantém estável, o caminho do utilizador também se mantém.

As equipas que executam aplicações em fase de preparação e produção podem reforçar isto mantendo as regras de encaminhamento alinhadas, reduzindo as alterações inesperadas durante a implementação.