Il QR code non funziona

Una checklist sintomo per sintomo per i codici che non si leggono, o che si leggono ma portano nel posto sbagliato, con la soluzione per ciascuno.

Risposta breveLa maggior parte dei QR code che non funzionano è troppo piccola per la distanza di scansione, troppo fitta perché l’URL è lungo, con poco contrasto, a colori invertiti o senza la zona di rispetto bianca attorno. Se il codice si legge ma non si apre niente di utile, il problema è il link stesso: un errore di battitura, una pagina che non c’è più o una destinazione spostata.

Prima di tutto, capisci che tipo di problema è

Dietro «non funziona» si nascondono due problemi molto diversi, che non hanno niente in comune. Prenditi dieci secondi per capire quale dei due hai prima di cambiare qualsiasi cosa.

  • La fotocamera non reagisce. Non compare nessuna anteprima del link. Il telefono non riesce a leggere il disegno, quindi la causa è fisica: dimensione, densità, contrasto, margine, superficie, o il modo in cui il codice è stato stampato o esportato.
  • La fotocamera lo legge, ma la pagina è sbagliata. Compare un’anteprima e si apre il browser, che però mostra un errore, la pagina sbagliata o niente. Il codice va bene; il problema è l’URL che contiene.

Per verificare il secondo caso, inquadra il codice e leggi l’indirizzo nell’anteprima prima di toccarlo. Se l’indirizzo è quello che volevi codificare, il codice funziona e la soluzione va cercata sul sito, non sulla stampa.

Sintomo, causa probabile, soluzione

Diagnosi di un QR code che non si legge
SintomoCausa probabileSoluzione
Si legge da vicino, non da dove stanno le personeCodice troppo piccolo per la distanzaStampalo a circa un decimo della distanza di scansione
Si legge solo con telefoni recenti; sembra una grana fineTroppo fitto: URL lungo, moduli piccoliAccorcia l’URL, o stampa il codice più grande
Non si legge mai, con nessun telefonoZona di rispetto tagliata, o codice su uno sfondo caricoRipristina un margine bianco libero largo quattro moduli
Un disegno chiaro su sfondo scuro non funzionaColori invertitiModuli scuri su sfondo chiaro
Un codice pallido o colorato non va con poca luceContrasto bassoUsa il nero, o un colore molto scuro, su bianco
Non funziona solo da certe angolazioniRiflessi da finitura lucida, plastificazione o superficie curvaFinitura opaca; zona piana; codice più grande sulle curve
I bordi sembrano sfocati o a scaliniBitmap piccola ingrandita per la stampaUsa l’SVG, o il PNG alla sua dimensione naturale o più piccolo
Alcuni telefoni lo leggono, altri rinuncianoModuli danneggiati, consumati o stampati maleRistampa; proteggi i codici che verranno maneggiati
Si legge, poi mostra un 404 o una pagina di errorePagina eliminata, spostata o dietro un loginRipristina la pagina o aggiungi un reindirizzamento sul sito
Si legge, poi apre il sito sbagliatoErrore di battitura nell’URL quando il codice è stato creatoRigeneralo da un URL corretto e verificato

Scorri la tabella in ordine. Dimensione, densità e zona di rispetto spiegano la maggior parte dei problemi, e controllarle costa meno di qualsiasi altra cosa.

Sistemare un codice che la fotocamera non legge

Dimensione e densità

Il telefono deve distinguere ogni modulo, cioè ogni quadratino, come una forma separata. Un URL lungo produce più moduli nella stessa area, quindi ognuno è più piccolo. Il generatore di questo sito mostra la versione e il numero di moduli sotto ogni codice; se il numero è alto, togli i parametri di tracciamento o usa un percorso più corto prima di ingrandire qualsiasi cosa. In dimensioni di un QR code per la stampa trovi le tabelle di distanza e densità, e quanti dati contiene un QR code spiega perché la lunghezza conta.

Contrasto e colore

Gli scanner cercano moduli scuri su sfondo chiaro. Codici invertiti, colori pastello e codici stampati sopra una foto o una sfumatura riducono tutti la differenza su cui si basa la fotocamera. Per questo i file scaricati da questo sito sono neri su bianco per impostazione predefinita, e il generatore personalizzato rifiuta le coppie di colori invertite o con poco contrasto; se ricolori un codice dopo, leggi prima colori dei QR code.

La zona di rispetto

Entrambi i download includono un margine bianco largo quattro moduli. Dice allo scanner dove finisce il simbolo. I grafici spesso lo tagliano o fanno arrivare un riquadro colorato fino al codice, e già questo può impedirne la lettura su qualsiasi telefono.

Superficie e qualità di stampa

  • Finiture lucide e plastificazioni riflettono la luce dritta nella fotocamera. Una finitura opaca risolve.
  • Superfici curve come bottiglie e bicchieri deformano il disegno. Tieni il codice piccolo rispetto alla curva, o mettilo su una zona piana dell’etichetta.
  • Bitmap ingrandite hanno bordi sfocati o a scalini. Per la stampa usa l’SVG vettoriale: vedi PNG o SVG.
  • Graffi e strappi eliminano moduli. La correzione degli errori recupera parte dei danni, non danni illimitati.

Sistemare un codice che si legge ma non porta da nessuna parte

Un codice statico contiene l’URL stesso, quindi apre esattamente ciò che è stato scritto quando è stato creato: né più né meno. Se quell’indirizzo è sbagliato o non esiste più, il codice non si può modificare, ma il sito di solito sì.

  • Pagina spostata o eliminata. Imposta sul vecchio indirizzo un reindirizzamento permanente verso quello nuovo. Tutti i codici stampati tornano a funzionare.
  • Errore di battitura nell’URL. Se controlli quell’indirizzo sbagliato, reindirizzalo; altrimenti rigenera il codice e ristampa.
  • La pagina richiede un login, o è un documento privato. Rendila pubblica, o condividi un link che non richieda un account.
  • Dominio scaduto. Rinnovalo. È l’unico problema che trasforma i vecchi codici in link al sito di qualcun altro.

I codici creati su questo sito non smettono di funzionare da soli: non c’è nessun servizio di reindirizzamento nel mezzo. Se un codice creato altrove ha smesso di funzionare, i QR code scadono? spiega perché a volte i codici dinamici lo fanno.

Accorgersene prima della stampa

  1. Incolla l’URL esatto in un browser e controlla che si carichi, senza essere connesso.
  2. Genera il codice e annota la versione indicata sotto.
  3. Stampa una prova alla dimensione finale, sul materiale finale.
  4. Inquadra la prova dalla distanza reale, con la luce reale, con almeno due telefoni diversi.
  5. Leggi l’indirizzo nell’anteprima della scansione, poi tocca per aprire la pagina.

Se stai inquadrando il codice di qualcun altro e il tuo telefono non reagisce proprio, il problema potrebbe essere dal lato del telefono: vedi come scansionare un QR code.

Crea un nuovo codice nero su bianco con la zona di rispetto inclusa:Genera un QR code

Domande correlate

Le cause tipiche sono un codice troppo piccolo per la distanza di scansione, troppo fitto perché l’URL è lungo, con poco contrasto o senza il margine bianco. Subito dopo vengono riflessi, superfici curve e immagini ingrandite e sfocate.

Il codice è al limite: le fotocamere recenti distinguono codici piccoli o fitti che quelle più vecchie non riescono a leggere. Ingrandisci il codice, accorcia l’URL per ridurre la densità o migliora il contrasto finché non si legge bene anche con i telefoni più vecchi.

Il codice funziona; l’indirizzo che contiene no. La pagina potrebbe essere stata spostata, eliminata o messa dietro un login. Ripristinala o aggiungi un reindirizzamento dal vecchio indirizzo, e il codice stampato tornerà a funzionare.

Non puoi cambiare il disegno, ma se il problema è la destinazione di solito puoi risolverlo sul sito con un reindirizzamento. Se il problema è la dimensione, il contrasto o un margine tagliato, il codice va ristampato.

Alcune fotocamere leggono i codici invertiti, ma molti scanner no, quindi falliscono in modo imprevedibile. Per tutto ciò che deve funzionare per chiunque, usa moduli scuri su sfondo chiaro.