Perché il tuo codice QR non si scansiona (e come risolvere): la guida completa alla risoluzione dei problemi

I codici QR falliscono per un numero ristretto di motivi ben noti. Segui questa guida dall'inizio alla fine e risolverai il 95% dei problemi di scansione in cinque minuti.

Il modo di vederla che aiuta è questo: ogni codice QR è un patto tra tre parti. Il codice stampato (o mostrato su schermo), il telefono che cerca di scansionarlo e il server a cui l'URL punta alla fine. Una scansione fallisce quando una di queste tre parti viene meno al patto.

Questa guida è organizzata in base a chi è il responsabile. La maggior parte dei problemi riguarda il codice stesso, quindi partiamo da lì.

La diagnosi rapida: scopri di chi è la colpa in 30 secondi

Prima di una risoluzione approfondita, fai questo test:

1. Prova un codice che sai funzionare. Apri un qualsiasi altro codice QR dinamico che hai già testato e scansionalo. Se quello si scansiona, il tuo telefono è a posto.
2. Prova il codice problematico su un altro telefono. Fattene prestare uno. Se quel telefono lo scansiona, il problema è il tuo telefono. Se non lo scansiona nessuno dei due, il problema è il codice.
3. Prova il codice problematico con più luce. Portalo vicino a una finestra o a una lampada accesa. Se ora si scansiona, il problema è la luce o il contrasto.
4. Leggi l'URL a mano se è stampato accanto al codice. Digitalo in un browser. Se la pagina si carica, la destinazione è a posto ed è il codice in sé a essere difettoso. Se la pagina non si carica, è la destinazione a essere rotta e il codice è innocente.

Qualunque sia il passaggio che ha rivelato il colpevole, salta alla sezione corrispondente qui sotto.

Problema 1: il codice è danneggiato fisicamente

I codici QR hanno una correzione d'errore integrata. Si può oscurare o danneggiare fino a circa il 30% del pattern e il codice si scansiona comunque. Ma quel "30%" è il massimo, e vale solo al livello di correzione d'errore più alto: molti codici reali vengono generati con una correzione d'errore più bassa e tollerano molti meno danni.

Che aspetto ha il danno:

• Pieghe o grinze che attraversano il codice
• Macchie di caffè, aloni d'acqua, sbavature di cibo
• Graffi che hanno rimosso l'inchiostro
• Scolorimento dovuto all'esposizione al sole
• Adesivi o etichette che coprono parte del codice
• Difetti di stampa (bande, disallineamenti, sbavature)

La soluzione:

• Per danni lievi (meno del 10% oscurato), la maggior parte delle fotocamere moderne legge comunque il codice. Prova a scansionarlo da angolazioni o distanze diverse.
• Per danni importanti serve una stampa nuova. Se il codice sottostante è dinamico, nessun problema: stampa una copia nuova. Se il codice è statico, l'URL è codificato direttamente nel pattern, quindi una nuova stampa dello stesso codice funzionerà.

La prevenzione: stampa i codici su materiali resistenti per qualsiasi luogo a forte affluenza. Plastificazione, espositori in acrilico e vinile resistente alle intemperie aggiungono anni alla vita utile di un codice. Per i codici all'aperto, l'inchiostro resistente ai raggi UV vale il costo extra.

Problema 2: il codice è stampato troppo piccolo

Un codice QR deve essere abbastanza grande da permettere alla fotocamera di distinguere i singoli moduli (i piccoli quadrati neri che compongono il pattern di dati).

La regola generale:

Dimensione minima = distanza di scansione ÷ 10

Un codice scansionato da 30 cm (la distanza di un braccio) deve misurare almeno 3 cm. Un codice scansionato da 3 metri (un poster appeso al muro) deve misurare almeno 30 cm.

In pratica, ecco le dimensioni minime per gli scenari più comuni:

• Biglietti da visita / espositori da tavolo: minimo 2,5–3 cm
• Annunci su riviste / volantini: 3–4 cm
• Vetrine dei negozi: 5–8 cm
• Poster a distanza ravvicinata al chiuso: 10–15 cm
• Poster grandi visti dall'altra parte di una stanza: 20–30 cm
• Cartelloni pubblicitari: dipende dalla distanza di visione; può superare il metro

La soluzione: se il tuo codice è al limite del troppo piccolo, ristampalo più grande. Se hai già stampato in grandi quantità, l'unica soluzione pratica è avvicinare il materiale stampato all'utente — ma di solito non è fattibile.

La prevenzione: misura due volte, stampa una volta sola. Testa sempre la dimensione effettiva di stampa nell'ambiente reale prima di stampare in grandi quantità.

Problema 3: il contrasto è troppo basso

I codici QR si scansionano nel modo più affidabile quando i quadrati scuri sono molto scuri e quelli chiari molto chiari. Il rapporto di contrasto tra i due deve essere alto.

I problemi di contrasto più comuni:

• Codice grigio a mezzitoni su sfondo bianco
• Codice scuro su sfondo di colore scuro
• Codici colorati (soprattutto pastello) senza contrasto sufficiente
• Codici bianchi su sfondo nero (funzionano sulla maggior parte dei telefoni moderni, falliscono sugli Android più datati)
• Codici con sovrapposizioni semitrasparenti
• Codici stampati su carta testurizzata o colorata, dove il colore sconfina nei moduli

La soluzione:

• Ristampa con un contrasto più alto. Nero su bianco è la scelta più sicura.
• Se ti serve un codice colorato per ragioni di brand, usa un colore molto scuro (blu navy intenso, verde bosco, bordeaux) su uno sfondo molto chiaro.
• Se il codice è su una superficie colorata, aggiungi un riquadro bianco attorno al codice stesso.

La prevenzione: testa il codice realmente stampato sulla carta o sulla superficie reale, nella luce reale. Un codice bellissimo nel mockup di design sul monitor calibrato di un grafico spesso fallisce in un ristorante poco illuminato.

Problema 4: riflessi o bagliori

Carta lucida, plastificazione, packaging in plastica ed espositori in acrilico lucido riflettono tutti la luce. Se il riflesso colpisce l'obiettivo della fotocamera, questa non riesce a vedere bene il codice.

La soluzione:

• Inclina il telefono di 15–20° rispetto all'asse. Questo spezza il riflesso senza compromettere la capacità della fotocamera di leggere il codice.
• Spostati in modo che la fonte di luce sia dietro di te, non dietro il codice.
• Per i codici su superfici lucide, abbassa le luci sopra la testa se puoi.

La prevenzione: evita le finiture molto lucide per i codici QR negli ambienti molto illuminati. Le finiture opache o satinate perdonano di più.

Problema 5: l'URL di destinazione è rotto

Il codice QR potrebbe scansionarsi alla perfezione, ma l'URL a cui punta restituisce un errore 404 (o un "impossibile raggiungere il sito"), così l'utente pensa che il codice non funzioni.

Come succede:

• La pagina di destinazione è stata spostata o eliminata.
• L'URL è stato digitato male quando il codice è stato generato.
• Il sito è temporaneamente offline.
• L'URL aveva un refuso o uno spazio di troppo.
• L'URL contiene caratteri che andavano codificati.

La soluzione:

• Se il codice è dinamico: accedi al tuo provider QR, cambia l'URL di destinazione e lo stesso codice punterà al nuovo URL. Niente ristampe. È il superpotere dei codici dinamici.
• Se il codice è statico: l'URL è incorporato nel codice. Non puoi cambiarlo. Le uniche opzioni sono ristampare con l'URL corretto oppure impostare un reindirizzamento all'URL originale sul tuo server.

La prevenzione: testa sempre l'URL di destinazione nel momento in cui generi il codice e di nuovo dopo che la pagina è online. Aggiornalo con regolarità se la struttura del tuo sito cambia.

Problema 6: il codice dinamico è scaduto o è stato disattivato

È il tipo di guasto più frustrante, perché il codice in sé è a posto: è solo che il server del provider non reindirizza più.

Cause comuni:

• La tua prova gratuita con il provider QR è terminata.
• Hai annullato o ridotto il tuo abbonamento e la policy del provider prevede di disattivare i codici dinamici alla cancellazione.
• Il tuo account è stato sospeso per mancato pagamento.
• Il provider ha chiuso l'attività.
• Il provider ha eliminato il codice per inattività (raro, ma succede).

La soluzione:

• Accedi al tuo account del provider QR. Se il codice è in pausa o disattivato, riattivalo (di solito significa rinnovare l'abbonamento).
• Se il provider ha chiuso o il tuo account non esiste più, dovrai generare nuovi codici su una nuova piattaforma e ristampare.

La prevenzione: è il motivo più importante in assoluto per scegliere un provider QR i cui codici non si rompono alla cancellazione. La policy di QR Cake prevede che i codici continuino a funzionare con l'ultima destinazione salvata anche dopo la cancellazione. La maggior parte dei provider a pagamento disattiva i codici alla fine dell'abbonamento. Leggi le clausole in piccolo prima di scommettere i tuoi materiali stampati su un provider.

Problema 7: problemi della fotocamera del telefono

Meno frequente di quanto si creda, ma capita.

I problemi più comuni lato telefono:

• L'obiettivo è sporco. Puliscilo con un panno in microfibra. Questo risolve più codici QR "rotti" di qualsiasi altro intervento.
• La app della fotocamera è quella sbagliata. Alcuni produttori Android hanno più app della fotocamera. Assicurati di usare quella standard con il supporto QR attivo.
• La scansione QR è disattivata nelle impostazioni della fotocamera. Alcuni Samsung e Xiaomi la nascondono in Impostazioni → Fotocamera → Scansiona codici QR.
• La fotocamera è in una modalità che non scansiona. La modalità selfie non scansiona in modo affidabile; alcune modalità "professionali" nemmeno. Usa la modalità foto standard.
• Il sistema operativo è troppo vecchio. iOS precedente all'11 e Android precedente all'8 non hanno la scansione QR integrata.

La soluzione: prova il codice problematico su un altro telefono oppure installa un'app di scansione di terze parti affidabile (TeaCapps QR & Barcode Scanner su Android; l'app Fotocamera dell'iPhone o lo Scanner di codici dal Centro di Controllo su iOS).

Problema 8: il codice è troppo denso

È un problema lato produzione facile da non notare. Più dati codifichi in un codice QR statico, più il pattern diventa fitto. Un URL breve produce un codice rado e facile da scansionare. Un URL lungo con parametri UTM produce un codice fitto e fragile.

La soluzione:

• Per i codici statici, accorcia l'URL prima di generare il codice. Usa un servizio di accorciamento URL o sposta il tracciamento UTM lato server.
• Meglio ancora: passa a un codice dinamico. I codici dinamici codificano sempre un breve URL di reindirizzamento, quindi il pattern resta rado e tollerante anche a dimensioni ridotte.

La prevenzione: non inserire mai URL lunghi nei codici QR statici se il codice verrà stampato piccolo. Testa il codice risultante alla dimensione di stampa prevista prima di procedere.

Problema 9: collocazione sbagliata

Anche un codice generato e stampato alla perfezione può fallire per via di dove si trova.

I problemi di collocazione più comuni:

• Dietro un vetro che riflette (vetrine dei musei, poster incorniciati)
• Su una superficie curva (packaging cilindrico, lattine)
• Su tessuto o materiale a maglia che deforma il pattern
• In una posizione in cui la luce arriva solo da un lato
• Dove gli utenti si avvicinano da un'angolazione che deforma il codice nella loro fotocamera

La soluzione: sposta il codice in una posizione piana, ben illuminata e accessibile. Testa sempre la collocazione reale prima di stampare in grandi quantità.

La prevenzione: tratta la collocazione come parte del design, non come un ripensamento dell'ultimo momento.

Problema 10: colori invertiti

I codici QR sono pensati per essere letti come "moduli scuri su sfondo chiaro". I codici invertiti — moduli chiari su sfondo scuro — funzionano sugli iPhone moderni e sugli Android recenti, ma i dispositivi più datati spesso falliscono.

La soluzione: stampa il codice con i quadrati scuri su sfondo chiaro. Anche se il tuo mockup di design mostra il contrario, la versione di produzione dovrebbe essere quella convenzionale.

La prevenzione: se ti serve un'estetica chiaro-su-scuro per ragioni di design, testa a fondo con telefoni Android più datati prima di procedere. Molti Android più vecchi (soprattutto i modelli economici) davvero non riescono a leggere i codici invertiti.

Come testare il tuo codice prima di stampare in grandi quantità

Prima di impegnarti a stamparne 1.000 copie, fai questo test da 10 minuti:

1. Stampa un codice alla dimensione reale prevista.
2. Scansiona con un iPhone (app Fotocamera).
3. Scansiona con un telefono Android (app Fotocamera o Google Lens).
4. Scansiona dalla distanza più ravvicinata a cui qualcuno potrebbe avvicinarsi.
5. Scansiona dalla distanza più lontana a cui qualcuno potrebbe avvicinarsi.
6. Spostati nel punto più buio della stanza in cui il codice potrebbe trovarsi e scansiona lì.
7. Testa su almeno un telefono con un sistema operativo più datato (iOS 14 o Android 9, se possibile).
8. Apri l'URL di destinazione e verifica che si carichi in meno di 3 secondi su mobile.

Se un passaggio fallisce, sistemalo prima di stampare in grandi quantità.

Domande frequenti

Perché il mio codice QR si scansiona su un telefono ma non su un altro? Di solito per uno di tre motivi: il telefono che funziona ha un'ottica migliore, un rilevamento QR via software migliore (sistema operativo più recente), oppure lo tieni a una distanza/angolazione diversa. Prova il telefono che non funziona seguendo i suggerimenti nella sezione sulla fotocamera qui sopra.

Il mio codice QR ieri funzionava e oggi no. Perché? Tre cause probabili, in ordine: (1) l'URL di destinazione è cambiato o ha restituito un errore, (2) l'abbonamento del codice dinamico è terminato, (3) il codice è stato danneggiato fisicamente.

Posso sistemare un codice QR statico senza ristamparlo? Non puoi cambiare il codice stesso: l'URL è incorporato. Ma se controlli il dominio dell'URL di destinazione, puoi impostare un reindirizzamento lato server dall'URL originale a uno nuovo. In questo modo il codice stampato continua a funzionare.

Perché alcuni codici QR si scansionano all'istante e altri ci mettono qualche secondo? Quelli che si scansionano in fretta hanno un contrasto più alto, una qualità di stampa migliore, una dimensione ottimale e pattern di dati radi (di solito URL brevi). Quelli lenti hanno una o più debolezze che il telefono deve faticare di più per superare.

Il livello di correzione d'errore incide sulla scansione? Sì. Una correzione d'errore più alta (L, M, Q, H — H è la più alta) rende i codici più tolleranti ai danni ma anche più fitti. La maggior parte dei generatori usa di default M (media), che va bene per la maggior parte dei casi. Per l'uso all'aperto o industriale, passa a Q o H.

Gli iPhone scansionano i codici QR che gli Android più datati non leggono? Spesso sì. In genere gli iPhone hanno un rilevamento QR migliore rispetto agli Android di fascia media e più datati. Se produci codici per il pubblico, ottimizza per il telefono ragionevolmente più debole tra il tuo pubblico, il che di solito significa un Android più datato.

I codici QR colorati sono meno affidabili? Non di per sé. L'affidabilità dipende dal contrasto, non dal colore. Un codice nero e un codice blu navy scuro funzionano altrettanto bene su sfondo bianco. Un codice giallo pastello su sfondo bianco funziona male. Testa prima di procedere.

Perché il mio codice funziona alla luce del giorno ma fallisce con l'illuminazione del ristorante? I livelli di luce influiscono sulla capacità di messa a fuoco della fotocamera e sul contrasto percepito del codice. Con poca luce, la fotocamera mette a fuoco più lentamente e può percepire meno contrasto rispetto alla luce del giorno. Codice più grande, contrasto più alto, superficie più adatta a evitare riflessi = prestazioni migliori con poca luce.

Nel dubbio

Se hai seguito tutta la guida e il tuo codice ancora non si scansiona, il problema è quasi certamente uno di questi:

• Codice generato con parametri difettosi (raro, ma capita — prova a rigenerarlo)
• Disservizio lato provider (controlla la pagina di stato del tuo provider)
• Il server di destinazione è offline o blocca il tuo traffico

Se nessuno di questi casi si applica, il codice potrebbe avere un sottile difetto di produzione. La soluzione più rapida è rigenerare il codice con un provider affidabile e ristamparlo.

Crea un nuovo codice QR dinamico