Um QR code que não funciona pode ter causas variadas. Identificar o problema correto economiza tempo e evita a frustração de tentar soluções que não se aplicam ao seu caso.
Problemas de hardware e ambiente
Iluminação insuficiente é a causa número 1. Ative a lanterna do celular em ambientes escuros. Segure o telefone estável — câmeras com foco rápido precisam de 1–2 segundos sem movimento. Limpe a lente com um pano macio; impressões digitais criam névoa que confunde o leitor.
Problemas com o código impresso
QR codes amassados, molhados ou com contraste insuficiente entre o fundo e os módulos não funcionam bem. A relação mínima de contraste é 4:1. Tamanho muito pequeno (menos de 2 cm × 2 cm para impressão) também impede a leitura confiável. Nunca imprima QR code em fundo transparente ou com cores muito similares.
Problemas com o link de destino
Se a câmera detecta o código mas a página não abre, o problema está no destino. Verifique se o domínio ainda está ativo, se o certificado SSL não expirou e se a URL não foi alterada. QR codes estáticos não permitem edição — considere migrar para dinâmicos.
Configurações do celular
Em alguns aparelhos Android, a leitura de QR deve ser ativada manualmente. Vá em Configurações > Câmera e procure "Digitalizar QR codes". No iPhone, certifique-se de que está no modo foto (não vídeo ou retrato) ao apontar a câmera.