Dlaczego mój kod QR się nie skanuje — 8 częstych błędów

Wygenerowałeś kod QR. Wydrukowałeś go. Ktoś próbował zeskanować… i nic się nie stało. Pomogliśmy użytkownikom zdebugować tysiące takich przypadków. Oto 8 najczęstszych powodów, dla których kod QR się nie skanuje, w przybliżonej kolejności częstotliwości.

1. Kod QR jest za mały

To powód numer 1. Kod QR potrzebuje wystarczającego fizycznego rozmiaru, aby kamera rozróżniła każdy pojedynczy moduł. Niezawodna reguła to proporcja 1:10 — bok kodu QR powinien mieć co najmniej jedną dziesiątą odległości skanowania.

• Skanowanie z 30 cm (telefon w ręce): drukuj minimum 3 cm szerokości
• Skanowanie z 1 m (plakat na ścianie): drukuj minimum 10 cm
• Skanowanie z 5 m (billboard): drukuj minimum 50 cm

W razie wątpliwości — zrób większy. Nie ma kary za zbyt duży kod QR.

2. Niski kontrast między ciemnymi a jasnymi modułami

Skaner musi wyraźnie odróżnić ciemne kwadraty od jasnego tła. Czarny na białym to złoty standard. Każdą mniej kontrastową kombinację trzeba dokładnie przetestować.

Reguła: jeśli nie czytasz wygodnie czarnego tekstu na tej samej kombinacji kolorów, kod QR prawdopodobnie też nie zeskanuje się niezawodnie.

3. Brak strefy quiet (marginesu)

Każdy kod QR potrzebuje strefy quiet — marginesu jasnych/pustych pikseli wokół niego, równego co najmniej 4 modułom (gdzie «moduł» to jeden z tych małych kwadracików). Bez niej skaner nie wie, gdzie kod się kończy.

Częsty winowajca: ktoś projektuje ulotkę, gdzie tekst lub obraz przylega zbyt blisko do QR. Albo daj kodowi QR oddech, albo wygeneruj go z wbudowanym marginesem (nasz generator robi to automatycznie).

4. Docelowy URL jest popsuty

QR się skanuje, telefon otwiera przeglądarkę i… 404. Sam kod QR działa fine; problem to link wewnątrz.

• Strona została przemianowana lub przeniesiona
• Łańcuch przekierowań gdzieś się rozpada
• Usługa bit.ly / dynamiczny QR wygasła lub ma rate-limit
• Strona wymaga logowania, a Twoja publiczność nie ma konta

To jeden z najmocniejszych argumentów za statycznymi kodami QR nad dynamicznymi — mniej punktów awarii.

5. Problemy z jakością druku

Twój projekt wygląda ostro na ekranie. Wydruk z drukarni jest rozmyty, atrament rozlewa się między modułami, albo całość ma błędy rejestru. Częste rozwiązania:

1. Zawsze eksportuj jako SVG (wektor, nieskończenie skalowalny) lub PNG w 2× rozmiarze druku
2. Dla bardzo małych kodów QR (poniżej 2 cm) używaj drukarki minimum 600 DPI
3. Unikaj drukowania na błyszczących czarnych tłach — odbicia mylą kamery
4. Powierzchnie zakrzywione lub zdeformowane (puszki, butelki) potrzebują większych kodów QR niż płaskie

6. Wbudowane logo jest za duże

Logo na środku kodów QR wygląda świetnie, ale jeśli logo zakrywa ponad ~25 % powierzchni, kod staje się nieczytelny. Rozwiązanie to zwiększenie poziomu korekcji błędów do H (high), który pozwala zasłonić do 30 % danych zanim kod zawiedzie.

7. QR jest na problematycznej powierzchni lub kącie

Kody QR preferują płaskie, matowe, dobrze oświetlone powierzchnie. Co szkodzi skanowalności:

• Powierzchnie odblaskowe — szklane gabloty, błyszczący laminat, ekrany za pleksiglasem
• Powierzchnie zakrzywione — puszki, butelki, kubki (kompensuj większym rozmiarem)
• Ostre kąty — naklejony pod 45° na ścianie (niektóre skanery sobie radzą, wiele nie)
• Bezpośrednie światło słoneczne — prześwietla kamerę
• Za szybą — dodaje odblaski i dodatkowe warstwy odbicia

8. Sam kod jest uszkodzony

Ten jest rzadki, ale realny. Jeśli skopiowałeś obraz QR i został skompresowany (np. screenshot, znowu screenshot, potem zapis JPEG), moduły mogą się ze sobą zlać. Zawsze pracuj na oryginalnym SVG lub PNG wygenerowanym przez narzędzie.