Um QR code que não escaneia quase nunca é um QR code quebrado. É um problema de física: a câmera não consegue ver o padrão com nitidez suficiente para decodificar. Aqui estão as causas na ordem em que eu de fato esbarro nelas.

1. Contraste insuficiente

De longe o mais comum. O leitor precisa distinguir módulos escuros dos claros. Cinza em bege fica charmoso e lê pessimamente. Vá de código realmente escuro em fundo realmente claro. Na dúvida, dessature o seu design e olhe em tons de cinza: se você tiver dificuldade, a câmera também vai ter.

2. Cores invertidas

Código claro em fundo escuro. Fica lindo e uma boa parte dos leitores vai recusar, porque a especificação espera escuro sobre claro e nem todo decodificador se dá ao trabalho de tentar o inverso. Se a sua marca exige um pôster escuro, coloque o código dentro de uma área clara nele.

3. A zona de silêncio sumiu

A margem em branco ao redor do código faz parte do código. A especificação pede o equivalente a quatro módulos de espaço vazio em todos os lados. Designers cortam isso o tempo todo porque parece respiro desperdiçado. Sem ela, o leitor não consegue achar onde o padrão começa.

4. Está pequeno demais para a distância

A regra grosseira: o código precisa ter mais ou menos um décimo da distância de leitura. Dois metros de distância significa um código de uns 20 cm. Um código de cartão de visita escaneado a 20 cm pode ter 2 cm. Os tamanhos e a conta de verdade estão no guia de tamanho para impressão.

5. O logo está comendo o código

QR codes têm correção de erros, então dá para cobrir parte do padrão e ainda decodificar. Mas existe um orçamento, e no nível mais alto ele é de uns 30 por cento. As pessoas centralizam um logo grande, cobrem 40 por cento, e ficam se perguntando por que morreu. Mantenha o logo pequeno, centralizado, e teste. Como fazer isso sem quebrar o código.

6. Dados demais espremidos ali dentro

Quanto mais você codifica, mais densa fica a grade. Uma URL de 300 caracteres com parâmetros de rastreamento vira uma malha fininha que câmeras baratas não conseguem resolver no tamanho impresso. Encurte a URL, ou use um código dinâmico para que o padrão guarde só um redirecionamento curto. Mais sobre versões e densidade.

7. A superfície está brigando com você

Papel brilhante, laminação, metalizado, garrafas curvas, tecido. O reflexo mata a leitura, a curvatura distorce a grade. Laminação fosca ganha da brilhante sempre. Em superfície curva, ganha a posição menor e mais plana.

8. O destino está morto

Se o celular escaneia numa boa e depois mostra um erro, o código fez o trabalho dele e o problema é a URL. Isso inclui o redirecionamento expirando, que é o que acontece quando um gerador de QR code "grátis" te entregou um código dinâmico com cronômetro de teste. Vale entender isso.

Como testar direito

Não no seu celular top de linha, a 10 cm, com boa luz. Assim passa tudo. Teste do jeito que ele vai ser usado de verdade:

Imprima no tamanho final, no material final.
Escaneie da distância real em que as pessoas vão ficar.
Use o pior celular que você achar, um Android velho e barato.
Teste na iluminação real, tanto restaurante na penumbra quanto sol forte.

Se sobreviver a isso, sobrevive na rua.

Ainda travado? Gere de novo limpo, sem logo, preto puro, configurações padrão, no estúdio. Se o simples escaneia e o seu não, o problema é o seu design, e esta lista vai te dizer em qual linha dela ele está.

Por que meu QR code não escaneia? Vá descendo nesta lista