QR Code não está lendo: 12 causas e como resolver cada uma

Quando um QR Code não lê, a causa quase nunca é o gerador. É uma entre um punhado de situações previsíveis, e todas têm solução. Este é um roteiro de diagnóstico, do mais provável para o menos provável.

Antes de tudo: teste na tela

Escaneie o código direto na tela do computador, antes de imprimir. Se ele lê na tela e não no papel, o problema é de impressão ou de tamanho. Se não lê nem na tela, o problema é do conteúdo ou do desenho. Esse único teste divide o diagnóstico pela metade.

1. Tamanho pequeno demais

A causa mais comum de todas. Aplique a regra dos 10 para 1: o lado do código deve ter no mínimo um décimo da distância de leitura. Detalhes e tabela completa no guia de tamanho para impressão.

2. Contraste insuficiente

Cinza claro sobre branco, amarelo sobre bege, azul-escuro sobre preto: combinações que parecem elegantes na tela e são ilegíveis para a câmera. O leitor precisa distinguir claramente módulo escuro de fundo claro. Na dúvida, imprima em preto e branco.

3. Cores invertidas

Código claro sobre fundo escuro falha em uma parcela relevante dos leitores, porque muitos algoritmos assumem módulos escuros sobre fundo claro. É esteticamente tentador e tecnicamente arriscado. Mantenha o padrão.

4. Margem branca invadida

Texto, moldura, borda colorida ou foto encostando no código. A zona livre de 4 módulos faz parte da especificação. Afaste tudo e o problema costuma sumir.

5. Logo grande demais no centro

Acima de aproximadamente 30% da área, nem a correção de erro alta recupera. Reduza o logo, centralize-o e teste. Detalhes em como colocar logo sem quebrar a leitura.

6. Fundo com textura ou imagem

Imprimir o código sobre uma fotografia derruba a taxa de leitura drasticamente, mesmo quando visualmente parece legível. Coloque o código sobre um retângulo sólido de cor clara.

7. Conteúdo longo demais

Muito conteúdo gera muitos módulos, módulos menores e leitura mais difícil. É o problema clássico do QR Code de contato com todos os campos preenchidos. Reduza a informação ou aumente o tamanho impresso.

8. Superfície curva, brilhante ou irregular

Garrafas, latas, embalagens plásticas e papel com verniz distorcem ou refletem. Posicione o código na área mais plana e fosca disponível e aumente o tamanho.

9. Impressão de baixa qualidade

Tinta borrada, papel absorvente, impressora com pouco toner ou arquivo PNG ampliado além da resolução. Os módulos se fundem e o leitor não distingue mais a grade. Use SVG sempre que for imprimir.

10. Iluminação do ambiente

Luz muito fraca faz a câmera perder contraste; luz direta e forte cria reflexo. Se o código fica em vitrine ou balcão sob spot, teste no local e no horário reais, não só no escritório.

11. Erro no conteúdo, não no código

Às vezes o código lê perfeitamente e o destino é que está errado. Sintomas típicos:

• Abre o navegador com erro de página: URL digitada errada ou sem "https://".
• Wi-Fi conecta com senha inválida: caractere especial na senha ou tipo de segurança errado. Veja a página de Wi-Fi.
• WhatsApp diz que o número é inválido: falta o código do país. Veja a página de WhatsApp.
• PIX abre com nome cortado: limite de 25 caracteres da especificação. Veja a página de PIX.

12. O leitor da pessoa

Aparelhos antigos, lente suja, câmera com pouca resolução ou aplicativo de câmera de terceiros que não reconhece o formato. Você não controla isso, mas mitiga: teste em pelo menos um iPhone e um Android, e sempre imprima a informação essencial em texto ao lado do código.

Roteiro rápido de verificação

1. Lê na tela do computador? Se não, o problema é conteúdo ou desenho.
2. O código está em preto sobre fundo branco sólido?
3. A margem branca em volta está livre?
4. O tamanho respeita a regra dos 10 para 1?
5. O logo, se houver, ocupa menos de 30% do centro?
6. O arquivo é SVG, ou PNG em 300 DPI no tamanho final?
7. Testou em dois aparelhos diferentes, na distância e na luz reais?

Passando por esses sete pontos, praticamente todo problema de leitura se resolve antes de virar prejuízo.