Você tem um QR code e nada o lê. A câmera paira, o leitor gira, e você não recebe nada. Frustrante — mas um QR que não decodifica quase sempre falha por uma de algumas razões concretas, e a maioria delas você resolve em menos de um minuto. Aqui está como descobrir qual está te pegando.
1. O código é pequeno demais no quadro
Essa é de longe a causa mais comum. Um QR code precisa de pixels suficientes para o decodificador distinguir seu padrão. Se o código é um quadradinho no canto de uma captura de tela grande, ou uma partícula distante em uma foto, simplesmente não há detalhe suficiente para ler.
Solução: Corte mais perto. Apare a imagem para o QR preencher a maior parte do quadro antes de tentar decodificar. Um código que preenchia 5% de uma captura de tela muitas vezes lê na hora depois de cortado para preencher 80%.
2. Está borrado ou fora de foco
O borrão de movimento de uma foto tremida, ou um foco suave, borra as bordas nítidas de que o padrão depende. O decodificador precisa de transições preto-e-branco nítidas.
Solução: Se é uma foto, tire de novo segurando firme, tocando para focar no código. Se é uma captura de tela de algo já borrado, há menos o que fazer — mas cortar até o código e tentar de novo ainda vale a tentativa, já que uma região menor e nítida às vezes decodifica onde a imagem suave inteira não decodificou.
3. Baixo contraste ou cores estranhas
Um QR depende de uma diferença clara entre os módulos escuros e o fundo claro. Uma impressão desbotada, um código sobre um fundo cheio de detalhes ou um código estilizado onde o "escuro" é uma cor pálida podem todos cair abaixo do limiar.
Solução: Prefira uma versão nítida, escuro sobre claro, se você tiver uma. Boas notícias sobre códigos invertidos, porém: um leitor de verdade tenta tanto o padrão normal quanto o invertido, então claro sobre escuro (código branco em fundo preto) ainda deve funcionar.
4. Brilho, reflexos ou luz irregular
Fotografar um código em uma superfície brilhante ou uma tela muitas vezes coloca um ponto de luz forte bem sobre o padrão, apagando parte dele. Fotos de tela para tela também captam interferência de moiré.
Solução: Mude o ângulo para eliminar o reflexo, e mire em iluminação uniforme em vez de um único ponto brilhante. Se o código está na sua própria tela, pule a câmera por completo — capture a tela e decodifique a imagem diretamente.
5. O código está danificado ou parcialmente coberto
QR codes têm correção de erro e conseguem sobreviver a algum dano, mas um grande arranhão, uma dobra atravessando um código impresso, um adesivo ou um dedo cobrindo um canto podem empurrá-lo além do recuperável. Os três grandes quadrados de posição nos cantos especialmente precisam estar intactos.
Solução: Se é físico, alise uma dobra ou limpe a superfície. Se parte está genuinamente faltando, nenhum leitor consegue inventar os dados de volta — você vai precisar de uma cópia limpa do código.
Decodifique da imagem, não de uma câmera tremida
Se o código já é um arquivo — uma captura de tela, uma foto salva, um gráfico exportado — você não precisa da câmera de jeito nenhum. Ler direto da imagem pula os problemas de foco e brilho por completo.
O Leitor de QR Code do IMG.DIY pega a imagem que você fornece, decodifica-a no seu navegador e mostra o texto — tentando tanto o padrão normal quanto o invertido automaticamente, e reduzindo imagens grandes para elas processarem rápido. Tudo roda localmente; nada é enviado.
Alguns limites honestos para alinhar expectativas: ele lê um código por imagem, então se uma foto contém vários, corte para o que você quer. E ele funciona a partir de uma imagem, não de uma webcam ao vivo — uma escolha deliberada para permanecer totalmente local. Códigos muito pequenos, borrados ou muito estilizados ainda podem resistir mesmo a um bom corte; quando isso acontece, a solução é quase sempre uma captura mais nítida, mais próxima e de maior contraste do código, em vez de uma ferramenta diferente.