Você gerou o QR Code, imprimiu, mas na hora H ele não lê. Frustrante, ainda mais se já foi para a gráfica. A boa notícia é que quase sempre a causa é uma destas poucas, e todas têm solução. Veja como diagnosticar.
1. Pequeno demais para a distância
É a causa mais comum. Se o código é lido de longe (um cartaz na parede) mas foi impresso pequeno, a câmera não distingue os módulos.
Solução: use a regra de proporção 1 para 10. O lado do QR deve ter pelo menos um décimo da distância de leitura. Cartaz lido a 2 metros pede um QR de pelo menos 20 cm.
2. Falta de margem branca
Todo QR precisa de uma borda branca ao redor, a zona de silêncio. Sem ela, o leitor não separa o código do fundo.
Solução: deixe uma margem equivalente a quatro módulos de cada lado. Nunca encoste texto, imagem ou a borda do material no código.
3. Contraste baixo
A câmera lê pela diferença entre o escuro e o claro. QR claro sobre fundo escuro, ou cores parecidas entre código e fundo, atrapalham.
Solução: use módulos escuros sobre fundo claro, o combo clássico. Evite imprimir o QR sobre foto ou textura movimentada.
4. Logo grande demais no centro
A correção de erro aguenta uma logo pequena, não uma que cobre um terço do código ou invade os cantos de posição.
Solução: mantenha a logo em no máximo 20% a 25% da área central e nunca sobre os três quadrados grandes dos cantos.
5. Baixa resolução ou imagem esticada
Um PNG pequeno ampliado no editor serra as bordas dos módulos. E esticar o QR para caber num espaço retangular deforma o código.
Solução: baixe em SVG (não perde qualidade) ou em PNG grande, e nunca deforme: o QR é sempre quadrado.
6. Impressão borrada ou danificada
Tinta fraca, papel absorvente ou o código dobrado numa emenda também derrubam a leitura.
Solução: imprima com boa qualidade e evite posicionar o QR em dobras ou vincos da peça.
O teste que evita retrabalho
Antes de rodar o material inteiro, imprima um QR de teste no tamanho real e escaneie com dois ou três celulares, de perto e da distância esperada. Se um falhar, ajuste antes. É o hábito que separa quem imprime mil peças que funcionam de quem imprime mil que não leem.