O erro NET::ERR_CLEARTEXT_NOT_PERMITTED geralmente ocorre quando um aplicativo Android tenta fazer uma solicitação de rede não segura em texto claro a um recurso ou servidor que exige uma conexão segura (HTTPS). Este erro é comum em aplicativos desenvolvidos para Android 9 (API nível 28) ou superior, onde a política de segurança foi fortalecida para melhorar a proteção dos dados do usuário. Este artigo oferece um guia detalhado sobre como corrigir esse erro, além de responder às perguntas mais frequentes relacionadas ao assunto.
Como Corrigir o Erro NET::ERR_CLEARTEXT_NOT_PERMITTED
Para Desenvolvedores de Aplicativos:
1. Ative Solicitações Cleartext no AndroidManifest.xml:
Se o seu aplicativo precisa fazer solicitações em texto claro por algum motivo específico, você pode explicitamente permitir isso adicionando o atributo android:usesCleartextTraffic="true" no arquivo AndroidManifest.xml dentro da tag <application>.
<application
...
android:usesCleartextTraffic="true">
...
</application>Note que ativar solicitações em texto claro para toda a aplicação pode não ser a melhor prática de segurança. Considere usar HTTPS sempre que possível.
2. Configuração de Network Security Config:
Para uma abordagem mais refinada, onde você pode especificar domínios que podem usar texto claro, use o Network Security Config. Primeiro, crie um arquivo de configuração de segurança de rede XML dentro da pasta res/xml do seu projeto (por exemplo, res/xml/network_security_config.xml).
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<domain-config cleartextTrafficPermitted="true">
<domain includeSubdomains="true">seudominio.com</domain>
</domain-config>
</network-security-config>Em seguida, referencie este arquivo no seu AndroidManifest.xml dentro da tag <application>:
<application
...
android:networkSecurityConfig="@xml/network_security_config">
...
</application>Para Usuários Gerais:
Se você não é um desenvolvedor e está encontrando esse erro ao tentar acessar um site através de um aplicativo, as soluções podem ser limitadas, mas aqui estão algumas dicas:
- Contate o Desenvolvedor do Aplicativo: Informe sobre o erro e sugira que eles atualizem o aplicativo para usar HTTPS em vez de HTTP.
- Verifique sua Conexão: Problemas de conexão podem, às vezes, causar erros inesperados. Tente se conectar usando uma rede diferente.
Perguntas Frequentes
Por que esse erro começou a aparecer agora?
A partir do Android 9 (Pie), a política padrão é não permitir tráfego em texto claro para melhorar a segurança dos dados do usuário. Aplicativos que não foram atualizados para cumprir com essas políticas de segurança mais rigorosas podem começar a exibir esse erro.
Alterar android:usesCleartextTraffic="true" é seguro?
Embora essa mudança possa resolver o erro, ela diminui a segurança ao permitir que todo o tráfego de rede do aplicativo seja transmitido em texto claro, o que pode expor dados sensíveis. É recomendado utilizar HTTPS sempre que possível.
Esse erro afeta todas as versões do Android?
Não. Esse erro é mais comum em dispositivos rodando Android 9 (Pie) ou superior, devido às políticas de segurança atualizadas. Em versões anteriores do Android, as solicitações em texto claro podem não resultar em erro, mas ainda representam um risco de segurança.
Posso corrigir esse erro sem acesso ao código do aplicativo?
Se você é apenas um usuário do aplicativo e não o desenvolvedor, suas opções são limitadas. A melhor ação é entrar em contato com o desenvolvedor do aplicativo e solicitar que eles atualizem o aplicativo para suportar conexões seguras.
O erro NET::ERR_CLEARTEXT_NOT_PERMITTED é uma medida de segurança implementada nas versões mais recentes do Android para encorajar o uso de conexões seguras. Para desenvolvedores, corrigir esse erro envolve permitir explicitamente o tráfego em texto claro (não recomendado) ou, idealmente
