Por que meu QR Code não é lido: 14 causas e como corrigir cada uma
Quando um QR Code impresso não funciona, a causa quase nunca está no código. Ela está na impressão, na superfície, na luz ou no destino. Esta lista está ordenada por frequência — do erro que aparece em quase toda gráfica ao que só acontece em caso específico —, e cada item traz o teste que confirma se é aquele o problema.
Antes de tudo, faça o teste de dois minutos: abra a imagem original do código na tela do computador e leia com o celular. Se ler na tela e não ler no papel, o problema é de impressão ou de material. Se não ler nem na tela, o problema é o arquivo. Essa única checagem separa as 14 causas em dois grupos.
1. A margem branca foi cortada
É a campeã absoluta. A norma ISO/IEC 18004 exige uma zona quieta de 4 módulos — uma faixa livre em volta de todo o símbolo. Sem ela, o leitor não consegue separar o código do resto da arte.
Acontece de três formas: o designer encaixa o QR dentro de um retângulo colorido; a gráfica corta no acabamento; ou alguém recorta a imagem "para tirar o espaço em branco sobrando". Esse espaço em branco não está sobrando.
Teste: meça a faixa clara em volta. Ela precisa ter, no mínimo, a largura de quatro quadradinhos do próprio código. Correção: reimprima com margem e deixe 5 mm extras de segurança para a faca.
2. O símbolo está pequeno demais para a distância
A regra prática do setor é dividir a distância de leitura por dez. Código lido a 30 cm precisa de 3 cm de lado; lido a 2 metros, precisa de 20 cm. Uma placa de imóvel com QR de 8 cm, lida da calçada, simplesmente não funciona.
Existe também um piso absoluto: cada módulo precisa de pelo menos 0,4 mm em impressão comum. Um código de versão alta (muitos módulos) impresso pequeno cruza esse limite mesmo respeitando a regra da distância.
Teste: aproxime o celular até ler. Se precisou chegar a menos da metade da distância de uso, o símbolo está pequeno. Correção: use a calculadora de tamanho com o seu conteúdo real.
3. O contraste está invertido ou fraco
Módulos escuros sobre fundo claro. O contrário — claro sobre escuro — é recusado por boa parte dos leitores, por mais bonito que fique no material. E tons médios sobre tons médios (cinza sobre bege, azul-claro sobre branco-gelo) reduzem a margem de leitura a quase nada.
Teste: tire uma foto do código e converta para preto e branco no próprio celular. Se os módulos sumirem, não há contraste suficiente. Correção: preto sobre branco; se precisar de cor, use uma cor escura de verdade.
4. Verniz brilhante ou laminação brilho por cima
O acabamento brilhante reflete a lâmpada do ambiente exatamente sobre o código, e a câmera vê uma mancha branca no lugar dos módulos. É um problema que só aparece no ponto de uso — na gráfica, sob luz difusa, o código parece perfeito.
Teste: incline o material sob uma lâmpada. Se aparece brilho sobre o código, é isso. Correção: laminação fosca, sempre. Em cardápio e embalagem, é a diferença entre funcionar e não funcionar.
5. O destino saiu do ar
O código está íntegro e é lido normalmente — o que falha é a página do outro lado. O sintoma é diferente dos anteriores: o celular reconhece e mostra o endereço, mas o navegador dá erro.
Teste: leia o código e observe se o celular mostra o conteúdo. Se mostrar, o símbolo está bom. Correção: restaure a página. E, para o futuro, aponte material impresso para um endereço estável do seu próprio domínio, nunca para um link temporário ou de serviço de terceiro que pode fechar.
6. Superfície curva
Garrafa, caneca, lata, tubo: a curvatura distorce os módulos e o leitor perde a geometria. Os padrões de alinhamento do QR Code corrigem distorção de perspectiva — foto tirada em ângulo —, mas não deformação física do próprio símbolo.
Correção: aumente o símbolo em pelo menos 30% e escolha a área menos curva. Em garrafa fina, considere colocar o código no rótulo traseiro plano ou numa tag pendurada.
7. Papel poroso ou tecido
Papel kraft, papel jornal, papelão sem revestimento e tecido absorvem tinta e borram as bordas dos módulos. Um símbolo que precisaria de 0,4 mm por módulo passa a precisar de 0,6 mm ou mais.
Correção: encurte o conteúdo para gerar um código de versão baixa (menos módulos, cada um maior) e aumente o tamanho de impressão. Em papelão kraft, imprima o código dentro de uma etiqueta branca em vez de direto no papelão.
8. Impressão em preto composto, com registro desalinhado
Numa impressão em quatro cores, o preto pode ser composto por ciano, magenta, amarelo e preto sobrepostos. Se o registro desalinha um fio de cabelo, cada módulo ganha uma franja colorida e as bordas somem.
Teste: olhe o código com uma lupa. Franja colorida nas bordas denuncia o problema. Correção: peça à gráfica preto chapado, só com a chapa K.
9. O conteúdo é longo demais para o espaço
Um vCard completo, um endereço com três parâmetros de campanha ou um texto de várias linhas empurram o símbolo para versões altas — 45×45, 57×57 módulos ou mais. Impresso no mesmo espaço, cada módulo fica minúsculo.
Teste: conte os quadradinhos de um lado do código. Acima de 45, o conteúdo está grande para material pequeno. Correção: encurte o endereço, tire parâmetros desnecessários ou aponte para uma página em vez de embutir o texto inteiro. Veja quanto cabe em cada versão.
10. O logotipo no meio cobriu demais
A correção de erro permite recuperar de 7% a 30% do símbolo danificado, e é isso que sustenta o logotipo no centro. Mas quem usa nível M (15%) e cobre 25% da área está pedindo falha — e quem cobre um dos três quadrados dos cantos inviabiliza a leitura em qualquer nível.
Correção: nível H, logotipo abaixo de 20% da área, centralizado, com fundo branco atrás e nunca sobre os localizadores. Detalhes em correção de erro.
11. A imagem foi redimensionada a partir de um PNG pequeno
Ampliar um PNG de 200 pixels para 10 cm produz bordas serrilhadas e módulos com meio-tom cinza nas extremidades. O leitor precisa decidir se cada pixel é claro ou escuro, e a serrilha atrapalha essa decisão.
Correção: use o SVG, que é vetorial e imprime nítido em qualquer tamanho. Se precisar de PNG, gere já no tamanho final: para 300 dpi, multiplique o lado em polegadas por 300.
12. Iluminação ruim ou reflexo no ponto de uso
Bar com luz baixa, vitrine com sol batendo no vidro, corredor com lâmpada atrás do cliente. A câmera precisa de contraste para binarizar a imagem, e nessas condições ela não consegue.
Correção: aumente o símbolo (mais área compensa menos luz), use fosco e, quando possível, reposicione. Em vitrine, colar o código do lado de dentro do vidro reduz o reflexo direto sobre ele.
13. O formato do conteúdo está errado
Aqui o código é lido perfeitamente e o celular não faz nada de útil. Os casos clássicos: senha de
Wi-Fi com ponto e vírgula sem escape, que corta a senha no meio; número de WhatsApp sem o
55; endereço sem https://, que vira texto em vez de link; BR Code de Pix
editado à mão, que invalida o CRC.
Teste: cole o conteúdo lido no decodificador. Ele mostra o formato campo a campo e, no Pix, valida o CRC.
14. O aparelho do usuário não suporta aquele formato
Alguns formatos têm suporte irregular. O esquema geo: funciona nativamente no Android
e falha em parte dos iPhones. O MECARD é bem lido no Android e menos no iOS. O texto pré-preenchido
de SMS varia entre versões do iOS. O QR de Wi-Fi só é nativo no Android a partir da versão 10.
Correção: em público misto, prefira os formatos universais — link, Pix, vCard, telefone — e teste sempre nos dois sistemas antes de imprimir.
O protocolo de teste antes de imprimir em escala
Cinco minutos que evitam uma tiragem inteira no lixo:
- Leia na tela. Confirma que o arquivo está correto.
- Imprima uma prova no tamanho final, em papel comum.
- Leia com três aparelhos: um iPhone, um Android recente e um aparelho com quatro ou cinco anos de uso. O antigo é o que revela símbolo pequeno demais.
- Leia na distância real e na iluminação real do lugar onde a peça vai ficar.
- Confira o destino: a página abre rápido em rede móvel? Ela funciona bem na tela do celular?
Se a peça for grande — banner, placa, fachada —, imprima só o pedaço com o código em tamanho real antes de fechar a arte inteira. Custa uma folha.
O que a correção de erro salva e o que não salva
Vale desfazer um mal-entendido comum. A correção Reed-Solomon do QR Code recupera dados perdidos nos módulos de informação. Ela não faz nada por:
- dano nos três localizadores dos cantos — sem eles o leitor não encontra o código;
- zona quieta ausente — o problema é anterior à decodificação;
- contraste insuficiente — a câmera não consegue nem definir o que é claro e o que é escuro;
- símbolo fora de foco ou pequeno demais — não há dado para corrigir.
Subir o nível de correção não resolve nenhum desses casos, e ainda aumenta o símbolo. É uma tentativa comum e inútil: quando a leitura falha por tamanho ou margem, aumentar a correção piora.
Quando o problema é o gerador
É raro, mas acontece. Geradores que aplicam uma máscara fixa em vez de avaliar as oito da norma produzem símbolos com grandes áreas uniformes, mais difíceis de ler. Outros esquecem a zona quieta no arquivo exportado. E alguns geram QR dinâmico com redirecionamento por um domínio que já saiu do ar — nesse caso o código está tecnicamente perfeito e leva a lugar nenhum.
O gerador deste site avalia as oito máscaras pela regra de penalidade da ISO/IEC 18004, inclui a zona quieta no arquivo exportado e produz apenas código estático — sem redirecionamento que possa sair do ar.