Perché il mio codice QR non funziona? Cause e soluzioni

Se il tuo codice QR non funziona, nella stragrande maggioranza dei casi la causa è uno di pochi problemi facili da sistemare: contrasto troppo basso tra il codice e lo sfondo, codice stampato troppo piccolo, margine bianco mancante intorno al codice (la cosiddetta zona di rispetto), un danno fisico che deforma il disegno, oppure una destinazione rotta come un link che non esiste più. Controllando questi punti in ordine, rimetti in funzione quasi tutti i codici.

In questa guida vediamo, una per una, le ragioni per cui un codice QR non si legge e come risolvere ciascuna, sia che tu stia creando un QR sia che tu stia provando a leggerne uno.

1. Contrasto troppo basso

I lettori QR riconoscono il codice misurando la differenza tra le zone scure e quelle chiare. Se il contrasto è insufficiente, la fotocamera non riesce a distinguere i singoli quadratini.

Come risolvere:

• Usa un codice scuro su sfondo chiaro, idealmente nero su bianco.
• Evita codici dai colori tenui, sfumature o QR stampati sopra una foto piena di dettagli.
• Se usi i colori del tuo brand, assicurati che le parti scure restino davvero scure. Un codice pallido può sembrare elegante, ma non si legge.

Un errore frequente è invertire i colori (codice chiaro su sfondo scuro). Alcuni lettori se la cavano, molti no: la scelta più sicura è tenere sempre il codice più scuro dello sfondo.

2. Il codice è troppo piccolo

Un codice QR ha bisogno di una dimensione fisica sufficiente perché la fotocamera distingua i singoli moduli, soprattutto da lontano.

Come risolvere:

• Per un codice letto a distanza di un braccio, punta ad almeno 2 x 2 cm.
• Per QR su poster o cartelli letti dall’altra parte di una stanza, ingrandisci molto, spesso 10 cm o più.
• Una regola semplice: la distanza di scansione dovrebbe essere circa dieci volte la larghezza del codice.

Più dati contiene un codice, più il disegno diventa fitto, e quindi va stampato ancora più grande per restare leggibile.

3. Manca la zona di rispetto

La zona di rispetto è il margine vuoto di spazio libero intorno al codice QR. I lettori la usano per capire dove inizia e dove finisce il codice. Senza, il QR si confonde con il testo o la grafica che ha attorno.

Come risolvere:

• Lascia un bordo libero pari ad almeno quattro moduli (i quadratini) su ogni lato.
• Non ritagliare il codice troppo stretto e non incollare testo o immagini a ridosso dei bordi.
• Quando progetti un volantino o un’etichetta, dai respiro al codice.

4. Danni fisici o deformazioni

I codici QR hanno una correzione d’errore integrata, quindi sopravvivono a qualche danno, ma solo fino a un certo punto.

Come risolvere:

• Controlla che non ci siano graffi, sbavature, pieghe o stampa consumata.
• Verifica che il codice sia ben piatto. Un QR su una bottiglia curva o su una superficie spiegazzata distorce il disegno.
• Ristampa i codici molto danneggiati. Se più di circa un terzo del codice è coperto, nemmeno una correzione d’errore forte riesce a recuperarlo.

5. L’URL o la destinazione è rotta

A volte il codice si legge perfettamente, ma la destinazione non si apre. Il lettore sta facendo il suo lavoro, il problema è dall’altra parte.

Come risolvere:

• Verifica che l’URL sia corretto e includa https://.
• Apri il link in un browser per controllare che la pagina sia ancora online.
• Attenzione ai refusi finiti dentro il codice al momento della creazione. Con un codice statico un refuso non si può correggere dopo: devi generare un codice nuovo.

Un modo affidabile per accorgertene in tempo è vedere in anteprima il link decodificato prima di fidarti del codice. QR Toolkit ti mostra il contenuto esatto già decodificato nell’istante in cui scansioni, così confermi che un codice punti dove deve prima di pubblicarlo o stamparlo.

6. Problemi di lettore o di luce

Ogni tanto il codice è perfetto e il problema è l’atto stesso della scansione.

Come risolvere:

• Pulisci la lente della fotocamera.
• Migliora l’illuminazione. Sia i riflessi sia le ombre disturbano la lettura.
• Tieni il telefono fermo e parallelo al codice, non inclinato.
• Prova un’app dedicata alla scansione invece della fotocamera. Se un codice è sbiadito o stampato su una superficie difficile, un lettore creato apposta spesso lo legge quando la fotocamera fa fatica, e può anche leggere da una foto salvata.

Una rapida checklist di diagnosi

Quando un codice non si legge, scorri questa lista:

1. C’è un buon contrasto (scuro su chiaro)?
2. È abbastanza grande per la distanza di scansione?
3. C’è spazio bianco libero intorno?
4. Il codice è integro e piatto?
5. L’URL di destinazione funziona ancora?
6. C’è buona luce e la lente è pulita?

Nove volte su dieci la risposta è qui dentro.

Provalo prima di fidarti

L’abitudine migliore in assoluto è testare ogni codice prima di metterlo in uso. Scansiona il tuo codice con almeno un altro telefono, nelle stesse condizioni in cui lo useranno le persone. Se puoi, salva il codice e tienine traccia. QR Toolkit conserva una cronologia ricercabile dei codici che crei e scansioni nel tuo account, così puoi ricontrollare o rigenerare al volo un codice che si rivela problematico, con la decodifica eseguita sul tuo dispositivo, senza pubblicità e senza tracciamento.

Domande frequenti

Perché il mio codice QR si legge su un telefono ma non su un altro?

Di solito è il segnale di un problema al limite: contrasto un po’ basso, dimensioni piccole o zona di rispetto troppo stretta. Una fotocamera ci riesce, un’altra no. Aumentare il contrasto, ingrandire il codice e lasciare un margine attorno lo rende leggibile in modo affidabile su ogni dispositivo.

Un codice QR danneggiato si può ancora leggere?

A volte sì. I codici QR hanno una correzione d’errore che recupera i dati anche se una parte del codice manca o è sbavata, spesso fino a circa il 30 per cento a seconda delle impostazioni. Oltre quella soglia il codice diventa illeggibile e va ristampato.

Il mio codice QR si legge ma il link è morto. Cosa è successo?

Il codice è a posto, ma il sito a cui punta è stato spostato o è andato offline. I codici QR statici non si possono modificare dopo la creazione: se la destinazione è cambiata dovrai generare un nuovo codice con l’URL corretto e funzionante.