Por que o QR code não funciona

Um QR code que não é lido parece um problema misterioso e quase nunca é. As causas possíveis são poucas, são físicas e podem ser checadas em ordem. Esta lista está ordenada pela frequência com que cada uma aparece na prática, então descendo por ela você resolve o caso comum antes de gastar tempo com o raro.

Antes de tudo, uma separação que economiza metade do trabalho: o código não é lido ou o código é lido e o que acontece depois está errado? São problemas completamente diferentes. Se o celular reconhece o código e mostra alguma coisa — um texto, um endereço, uma proposta de conexão — a leitura está funcionando e o problema está no conteúdo, tratado no fim desta página. Se a câmera fica parada sem reconhecer nada, continue lendo daqui.

1. Contraste insuficiente

É a causa mais comum e a mais fácil de introduzir sem perceber, porque ela nasce quase sempre de uma decisão de design.

O leitor precisa distinguir módulo escuro de módulo claro. A conta prática é a razão de contraste entre as duas cores, e abaixo de 3:1 a maioria dos leitores falha. Um código cinza-médio sobre fundo bege, ou azul-claro sobre branco, pode parecer elegante na tela do designer e ser ilegível na mão do cliente.

Dois casos específicos que aparecem muito:

• Código claro sobre fundo escuro. O formato pressupõe o contrário. Câmeras de celular modernas costumam dar conta, mas leitores dedicados recusam.
• Cor no fundo e cor no código. Se os dois lados são coloridos, o contraste costuma cair mais do que parece. Deixe um dos dois praticamente branco ou praticamente preto.

2. Módulos pequenos demais

O que decide a leitura não é o tamanho do código: é o tamanho de um módulo, um quadradinho individual. Duas coisas aumentam a contagem de módulos e portanto diminuem cada um deles dentro do mesmo espaço impresso: mais dados e mais correção de erros.

É por isso que um código de link curto impresso a dois centímetros funciona bem e um cartão de contato completo no mesmo tamanho falha. O segundo tem muito mais módulos espremidos na mesma área.

Em impressão comum, mire em pelo menos 0,4 mm por módulo. E a regra de bolso para o código inteiro: o lado deve ser mais ou menos um décimo da distância de leitura. Trinta centímetros de distância pedem três centímetros de código; dois metros pedem vinte.

Se o código não cabe no tamanho necessário, a solução é reduzir os dados, não espremer o código. Encurte o endereço, tire campos opcionais, corte parâmetros de campanha.

3. Zona de silêncio invadida

A borda vazia em volta do código não é margem de design: é parte da especificação. São quatro módulos de espaço livre em todos os lados, e é o que permite ao leitor separar o padrão do que está em volta.

Essa é a falha mais traiçoeira da lista, porque o código continua parecendo perfeitamente inteiro. O que costuma invadir a zona de silêncio:

• Uma moldura decorativa desenhada rente ao código
• Texto ou logo encostados na borda
• O corte do papel passando perto demais numa etiqueta ou adesivo
• Um fundo colorido que termina exatamente na borda do padrão

A correção é trivial e custa apenas espaço de layout: afaste tudo.

4. Reflexo do material

Esta é a causa que mais aparece em estabelecimento e quase nunca em teste.

Plástico laminado brilhante, adesivo de vitrine, papel couché, verniz localizado, uma capa de cardápio plastificada — todos refletem. Um reflexo em cima da parte errada do padrão impede a leitura exatamente como se faltasse tinta ali, e ele muda de lugar conforme a pessoa se move, o que faz o problema parecer intermitente e aleatório.

Acabamento fosco resolve na origem. Se não der para escolher, suba a correção de erros e teste sob a luz real do ambiente — não sob a luz do escritório onde a arte foi aprovada.

5. Superfície curva ou ângulo extremo

Códigos em garrafas, latas, canecas e canudos ficam deformados. O padrão de alinhamento existe justamente para corrigir isso, mas ele tem limite, e códigos pequenos nem sequer têm esse padrão.

Em superfície curva, deixe o código menor em relação à circunferência e prefira a área mais plana disponível. Em rótulo de garrafa, isso normalmente significa posicionar o código no eixo vertical, não no horizontal.

6. Impressão degradada

Tinta que espalha em papel poroso, impressão a jato em papel comum, gravação a laser rasa, bordado, relevo. Todos borram as bordas dos módulos, e módulo borrado é módulo ambíguo.

Um código funciona no PDF e falha no material impresso mais vezes do que qualquer outra combinação nesta lista. Peça uma prova física no material e no tamanho finais e escaneie de verdade, com mais de um aparelho, antes de autorizar a tiragem. É o passo que mais evita prejuízo e o mais pulado.

7. Desgaste, depois de instalado

Um código que funcionava e parou é quase sempre dano físico. Em mesa de restaurante: gordura, água, cera de vela, produto de limpeza. Em vitrine: sol, que desbota tinta ciano e magenta primeiro e vai reduzindo o contraste até cruzar o limite. Em piso ou balcão: atrito.

O sintoma é o pior possível para um negócio, porque é gradual: o código funciona para a maioria e falha para alguns, e a equipe só descobre quando alguém reclama. A resposta é rotina, não conserto — plastifique e revise alguns por semana.

Quando o código é lido e o problema é outro

Se o celular reconhece o código, a leitura está resolvida e o que sobrou é conteúdo. Os três casos frequentes:

Mostra um texto em vez de abrir a página. Falta o https:// no começo do conteúdo. Sem esquema, muitos leitores tratam tudo como texto puro.

Oferece conectar ao Wi-Fi e a conexão falha. A senha quase certamente tem um ;, : ou \ que foi escapado errado — ou que alguém escapou à mão além do que o gerador já fazia. Vale checar também se a caixa de rede oculta está marcada sem necessidade, e se o nome da rede tem um espaço invisível no fim.

Abre e a página não carrega. Isso não é um problema do código: é falta de sinal. Subsolo, elevador, prédio de estrutura pesada, Wi-Fi de estabelecimento sobrecarregado. O código foi lido perfeitamente; o que faltou foi rede.