Contraste invertido ou fraco
A câmera não vê cores: vê diferença de luminosidade. O código precisa ser escuro sobre fundo claro. Um código claro sobre fundo escuro — branco no preto, amarelo no roxo — é a causa número um de falha, porque o leitor não encontra os três quadrados de posicionamento nos cantos.
Se você quer cor, escureça a cor do código e mantenha o fundo bem claro. Um contraste abaixo de 3:1 entre módulo e fundo é território de falha, mesmo que na tela pareça bonito.
Tamanho pequeno demais para a distância
A regra prática de campo: o lado do código deve ter cerca de 1/10 da distância de leitura. Para escanear a 30 cm (folha na mão), 3 cm bastam. Para um cartaz lido a 2 metros, o código precisa de uns 20 cm.
Em impresso, 2,5 cm é o piso absoluto. Abaixo disso, mesmo uma câmera boa não separa os módulos.
Falta de margem em volta
O código precisa de uma zona de silêncio: uma faixa clara e vazia equivalente a quatro módulos em toda a volta. Sem ela, o leitor não sabe onde o código termina — e falha mesmo com o desenho perfeito.
Cortar o código no limite da arte ou colá-lo grudado num texto quebra essa zona. Deixe respiro.
Logo grande demais no centro
O QR Code tem correção de erro embutida, o que permite cobrir uma parte pequena da área central sem perder a informação. Mas "pequena" significa até cerca de 20% da área — e nunca sobre os cantos de posicionamento.
Se você colocou a marca e a leitura ficou instável, reduza a logo e teste em dois celulares antes de fechar o arquivo.
Conteúdo longo demais
Quanto mais texto, mais módulos, e módulos menores no mesmo espaço físico. Um link enorme com parâmetros de campanha vira um código denso que só lê de perto e com boa luz.
Encurte o destino, use um endereço curto do próprio site e deixe os parâmetros para o mínimo necessário.
Material e superfície
Plástico brilhante, vinil espelhado e vidro refletem a luz do ambiente direto na lente e apagam parte do desenho. Superfícies curvas — garrafa, copo, caneca — distorcem a grade.
Prefira acabamento fosco e superfície plana. Em curvas, aumente o código e reduza o conteúdo.
Erros de conteúdo que parecem erro de leitura
Muitas vezes o código lê perfeitamente — e o que falha é o destino. Link com http quebrado, senha de Wi-Fi com o tipo de segurança errado, número de telefone sem código do país, chave PIX digitada com um caractere trocado.
Antes de culpar a impressão, escaneie o arquivo digital na tela do computador. Se ler ali e o destino estiver errado, o problema é o conteúdo, não o código.
- Wi-Fi: confirme WPA/WPA2 e o nome da rede com maiúsculas idênticas.
- Telefone e WhatsApp: sempre no formato internacional, com o código do país.
- Links: teste o endereço no navegador antes de gerar.
Teste em condições reais
Um código aprovado na tela do computador, com zoom, pode falhar no balcão. Teste no material final, na luz do lugar onde ele vai ficar, com um Android e um iPhone, à distância real de quem vai escanear. É o único teste que conta.