Dlaczego Twój kod QR się nie skanuje (i jak to naprawić): kompletny przewodnik rozwiązywania problemów

Kody QR nie działają z kilku dobrze znanych powodów. Przejdź przez ten przewodnik od początku do końca, a w pięć minut naprawisz 95% problemów ze skanowaniem.

Pomocne ujęcie sprawy: każdy kod QR to umowa między trzema stronami. Wydrukowanym (lub wyświetlonym) kodem, telefonem próbującym go zeskanować i serwerem, do którego ostatecznie prowadzi URL. Skanowanie kończy się niepowodzeniem, gdy którakolwiek z tych trzech stron łamie umowę.

Ten przewodnik dzieli problemy według tego, która strona jest ich źródłem. Większość problemów dotyczy samego kodu, więc od niego zaczynamy.

Szybka diagnoza: ustal, kto jest winny w 30 sekund

Zanim przejdziesz do szczegółowego rozwiązywania problemów, wykonaj ten test:

1. Spróbuj zeskanować kod, o którym wiesz, że działa.Otwórz dowolny inny dynamiczny kod QR, który wcześniej testowałeś, i zeskanuj go. Jeśli skanuje się poprawnie, Twój telefon działa prawidłowo.
2. Spróbuj zeskanować problematyczny kod innym telefonem.Pożycz telefon od kogoś. Jeśli tamten telefon zeskanuje kod, problem leży po stronie Twojego urządzenia. Jeśli żaden z telefonów go nie zeskanuje, problem jest po stronie samego kodu.
3. Spróbuj zeskanować problematyczny kod przy lepszym oświetleniu.Zabierz kod pod okno albo jasną lampę. Jeśli teraz się zeskanuje, problemem jest oświetlenie lub kontrast.
4. Wpisz adres URL ręcznie, jeśli jest wydrukowany obok kodu.Wprowadź go w przeglądarce. Jeśli strona się ładuje, cel jest poprawny, a kod jest uszkodzony. Jeśli strona nie działa, problemem jest miejsce docelowe, a kod jest niewinny.

Bez względu na to, który krok wskazał winnego, przejdź do odpowiedniej sekcji poniżej.

Problem 1: Kod jest fizycznie uszkodzony

Kody QR mają wbudowaną korekcję błędów. Można zasłonić lub uszkodzić około 30% wzoru, a kod nadal będzie się skanował. Te „30%” to jednak maksimum przy najwyższym poziomie korekcji błędów — wiele kodów używanych w praktyce jest generowanych z niższym poziomem korekcji i toleruje znacznie mniejsze uszkodzenia.

Jak wyglądają uszkodzenia:

• Zagięcia lub zgniecenia na kodzie
• Plamy po kawie, ślady po wodzie, zabrudzenia jedzeniem
• Zarysowania usuwające farbę
• Blaknięcie wskutek działania słońca
• Naklejki lub etykiety zasłaniające część kodu
• Wady druku (paski, przesunięcia, rozmazy)

Jak to naprawić:

• Przy drobnych uszkodzeniach (mniej niż 10% zasłoniętego wzoru) większość nowoczesnych aparatów w telefonach nadal odczyta kod. Spróbuj zeskanować go pod różnymi kątami i z różnych odległości.
• Przy poważnych uszkodzeniach potrzebny jest nowy wydruk. Jeśli kod jest dynamiczny, to żaden problem — wydrukuj nową kopię. Jeśli kod jest statyczny, adres URL jest zakodowany bezpośrednio we wzorze, więc świeży wydruk tego samego kodu też zadziała.

Jak zapobiegać:drukuj kody na wytrzymałych materiałach, jeśli będą umieszczone w miejscach o dużym natężeniu ruchu. Laminowanie, akrylowe stojaki i wodoodporny winyl znacznie wydłużają żywotność kodu. Przy kodach zewnętrznych warto zainwestować w tusz odporny na promieniowanie UV.

Problem 2: Kod jest wydrukowany zbyt mały

Kod QR musi być na tyle duży, by aparat mógł rozdzielić pojedyncze moduły (małe czarne kwadraty tworzące wzór danych).

Ogólna zasada:

Minimalny rozmiar = odległość skanowania ÷ 10

Kod skanowany z 30 cm (na odległość wyciągniętej ręki) powinien mieć co najmniej 3 cm. Kod skanowany z 3 metrów (plakat na ścianie) powinien mieć co najmniej 30 cm.

W praktyce minimalne rozmiary dla typowych sytuacji:

• Wizytówki / stojaki na stoliki: minimalnie 2,5–3 cm
• Reklamy w magazynach / ulotki: 3–4 cm
• Okna sklepowe: 5–8 cm
• Plakaty w pomieszczeniach, z bliskiej odległości: 10–15 cm
• Duże plakaty oglądane z drugiego końca pomieszczenia: 20–30 cm
• Billboardy: zależnie od odległości oglądania; może być ponad metr

Rozwiązanie: jeśli Twój kod jest minimalnie za mały, wydrukuj go w większym rozmiarze. Jeśli zdążyłeś już wydrukować dużą partię, jedynym praktycznym rozwiązaniem jest przybliżenie materiału do użytkownika — co zwykle nie jest możliwe.

Zapobieganie: mierz dwa razy, drukuj raz. Zawsze testuj rzeczywisty rozmiar wydruku w rzeczywistym środowisku przed drukiem na większą skalę.

Problem 3: Zbyt niski kontrast

Kody QR skanują się najpewniej, gdy ciemne kwadraty są bardzo ciemne, a jasne bardzo jasne. Kontrast między nimi musi być wysoki.

Typowe błędy związane z kontrastem:

• Kod w odcieniach szarości na białym tle
• Ciemny kod na ciemnym tle
• Kolorowe kody (szczególnie pastelowe) bez wystarczającego kontrastu
• Białe kody na czarnym tle (działa na większości nowoczesnych telefonów, na starszych Androidach może nie działać)
• Kody z półprzezroczystymi nakładkami
• Kody drukowane na papierze o fakturze lub kolorze, gdzie barwa przenika do modułów

Rozwiązanie:

• Przedrukuj z wyższym kontrastem. Najbezpieczniejszy jest czarny na białym tle.
• Jeśli potrzebujesz kolorowego kodu dla celów brandingowych, użyj bardzo ciemnego koloru (głęboki granat, ciemna zieleń, bordo) na bardzo jasnym tle.
• Jeśli kod jest umieszczony na kolorowej powierzchni, dodaj wokół samego kodu białą ramkę.

Zapobieganie:przetestuj realnie wydrukowany kod na realnym papierze lub powierzchni, w rzeczywistym oświetleniu. Kod, który pięknie wygląda w projekcie na skalibrowanym monitorze grafika, często nie działa w słabo oświetlonej restauracji.

Problem 4: Odblaski lub refleksy

Błyszczący papier, laminat, plastikowe opakowania i lśniące stojaki akrylowe odbijają światło. Jeśli refleks trafia w obiektyw aparatu, aparat nie widzi kodu wyraźnie.

Rozwiązanie:

• Przechyl telefon o 15–20° względem osi. To „zerwie” odbicie bez utraty możliwości odczytu kodu przez aparat.
• Przesuń się tak, by źródło światła znalazło się za Tobą, a nie za kodem.
• Przy kodach na błyszczących powierzchniach ścisz światła sufitowe, jeśli to możliwe.

Zapobieganie:unikaj bardzo gładkich wykończeń przy kodach QR eksponowanych w miejscach o silnym oświetleniu. Matowe i satynowe wykończenia są bardziej wyrozumiałe.

Problem 5: Docelowy adres URL jest nieaktywny

Kod QR może skanować się idealnie, ale adres URL, do którego prowadzi, zwraca błąd 404 (albo komunikat „strona jest niedostępna”), więc użytkownik myśli, że to kod nie działa.

Jak do tego dochodzi:

• Docelowa strona została przeniesiona lub usunięta.
• Adres URL został błędnie wpisany podczas generowania kodu.
• Strona jest tymczasowo niedostępna.
• W adresie URL była literówka albo dodatkowa spacja.
• Adres URL zawiera znaki, które wymagały zakodowania.

Rozwiązanie:

• Jeśli kod jest dynamiczny:zaloguj się do swojego dostawcy kodów QR, zmień docelowy adres URL i ten sam kod teraz wskazuje na nowy adres URL. Nie trzeba go ponownie drukować. To jest supermoc kodu dynamicznego.
• Jeśli kod jest statyczny:adres URL jest wbudowany w kod. Nie możesz go zmienić. Jedynymi opcjami są ponowne wydrukowanie z poprawnym adresem URL lub ustawienie przekierowania pod pierwotnym adresem URL na własnym serwerze.

Zapobieganie:zawsze testuj docelowy adres URL w momencie generowania kodu i ponownie po uruchomieniu strony. Regularnie aktualizuj, jeśli zmieni się struktura witryny.

Problem 6: Kod dynamiczny wygasł lub został wyłączony

To najbardziej uciążliwy tryb awarii, bo sam kod jest poprawny — problem polega na tym, że serwer dostawcy nie wykonuje już przekierowań.

Typowe przyczyny:

• Skończył się Twój darmowy okres próbny u dostawcy kodów QR.
• Anulowałeś lub obniżyłeś plan subskrypcji, a polityka dostawcy przewiduje wyłączenie kodów dynamicznych po anulowaniu.
• Konto zostało zawieszone z powodu braku płatności.
• Dostawca zakończył działalność.
• Dostawca usunął kod z powodu braku aktywności (rzadko, ale się zdarza).

Rozwiązanie:

• Zaloguj się na konto u swojego dostawcy kodów QR. Jeśli kod jest zawieszony lub wyłączony, aktywuj go ponownie (co zwykle oznacza ponowną subskrypcję).
• Jeśli dostawca zakończył działalność lub Twoje konto zostało usunięte, będziesz musiał wygenerować nowe kody na nowej platformie i ponownie je wydrukować.

Zapobieganie: to jest najważniejszy powód, by wybrać dostawcę QR, którego kody nie przestają działać po anulowaniu. Polityka QR Cake przewiduje, że kody nadal działają pod ostatnim zapisanym adresem nawet po anulowaniu. Większość płatnych dostawców dezaktywuje kody po zakończeniu subskrypcji. Przeczytaj dokładnie regulamin, zanim oprzesz swoje wydrukowane materiały na konkretnym dostawcy.

Problem 7: Problemy z aparatem w telefonie

Występują rzadziej, niż się powszechnie sądzi, ale się zdarzają.

Typowe problemy po stronie telefonu:

• Obiektyw jest zabrudzony. Przetrzyj go ściereczką z mikrofibry. To naprawia więcej „zepsutych” kodów QR niż jakakolwiek inna ingerencja.
• Zła aplikacja aparatu. Niektórzy producenci Androida mają kilka aplikacji aparatu. Upewnij się, że używasz standardowej, z włączonym skanowaniem kodów QR.
• Skanowanie QR jest wyłączone w ustawieniach aparatu. Niektóre modele Samsunga i Xiaomi ukrywają tę opcję w Ustawieniach → Aparat → Skanuj kody QR.
• Aparat jest w trybie, który nie skanuje. Tryb selfie nie skanuje niezawodnie; niektóre tryby „pro” również. Używaj standardowego trybu zdjęć.
• System operacyjny jest zbyt stary. iOS przed wersją 11 i Android przed wersją 8 nie mają wbudowanego skanera QR.

Rozwiązanie: wypróbuj problematyczny kod na innym telefonie, lub zainstaluj niezawodną aplikację skanującą innej firmy (TeaCapps QR & Barcode Scanner na Androida; aplikacja Aparat na iPhonie lub Code Scanner z Centrum sterowania na iOS).

Problem 8: Kod jest zbyt gęsty

To błąd po stronie twórcy, który łatwo przeoczyć. Im więcej danych zakodujesz w statycznym kodzie QR, tym gęstszy staje się wzór. Krótki adres URL daje rzadki, łatwy do zeskanowania kod. Długi adres URL z parametrami UTM daje gęsty, kruchy kod.

Rozwiązanie:

• W przypadku kodów statycznych skróć adres URL przed wygenerowaniem kodu. Użyj skracacza URL lub przenieś śledzenie UTM na stronę serwera.
• Lepiej: przesiądź się na kod dynamiczny. Kody dynamiczne zawsze kodują krótki adres URL przekierowujący, dzięki czemu wzór jest rzadki i wyrozumiały nawet przy małych rozmiarach.

Zapobieganie: nigdy nie umieszczaj długich adresów URL w statycznych kodach QR, jeśli kod będzie drukowany w małym rozmiarze. Przetestuj wygenerowany kod w planowanym rozmiarze druku przed zatwierdzeniem.

Problem 9: Złe umiejscowienie

Nawet perfekcyjnie wygenerowany i idealnie wydrukowany kod może nie działać z powodu miejsca, w którym się znajduje.

Częste błędy w lokalizacji:

• za szkłem, które odbija (ekspozycje muzealne, plakaty w ramach),
• na zakrzywionej powierzchni (cylindryczne opakowania, puszki),
• na tkaninie lub dzianinie, które zniekształcają wzór,
• w miejscu, gdzie światło dociera tylko z jednej strony,
• tam, gdzie użytkownicy podchodzą pod kątem, co zniekształca kod w ich aparacie.

Rozwiązanie: przenieś kod na płaską, dobrze oświetloną i dostępną powierzchnię. Zawsze testuj faktyczne umiejscowienie przed drukiem wielkoseryjnym.

Zapobieganie: traktuj umiejscowienie jako część projektu, a nie jako dodatek.

Problem 10: Odwrócone kolory

Kody QR zaprojektowano tak, by były odczytywane jako „ciemne moduły na jasnym tle”. Odwrócone kody — jasne moduły na ciemnym tle — działają na nowoczesnych iPhone’ach i nowszych telefonach z Androidem, ale starsze urządzenia często sobie z nimi nie radzą.

Naprawa: wydrukuj kod z ciemnymi kwadratami na jasnym tle. Nawet jeśli w projekcie jest inaczej, wersja produkcyjna powinna być klasyczna.

Zapobieganie: jeśli z powodów estetycznych potrzebujesz jasnych elementów na ciemnym tle, dokładnie przetestuj kod na starszych telefonach z Androidem przed zatwierdzeniem. Wiele starszych Androidów (zwłaszcza modeli budżetowych) naprawdę nie potrafi odczytać odwróconych kodów.

Jak przetestować kod przed drukiem dużej ilości

Zanim wyślesz do druku 1000 egzemplarzy, wykonaj ten 10-minutowy test:

1. Wydrukuj jeden kod w planowanym docelowym rozmiarze.
2. Zeskanuj go iPhone’em (aplikacja Aparat).
3. Zeskanuj telefonem z Androidem (aplikacja Aparat lub Google Lens).
4. Zeskanuj z najbliższej odległości, z jakiej ktoś może podejść.
5. Zeskanuj z najdalszej odległości, z jakiej ktoś może patrzeć.
6. Przejdź do najciemniejszego miejsca, w którym może być kod, i tam zeskanuj.
7. Przetestuj na co najmniej jednym telefonie ze starszym systemem operacyjnym (jeśli to możliwe, iOS 14 lub Android 9).
8. Otwórz docelowy URL i sprawdź, czy ładuje się w mniej niż 3 sekundy na urządzeniu mobilnym.

Jeśli którykolwiek krok zawiedzie, napraw go przed drukiem na dużą skalę.

Najczęściej zadawane pytania

Dlaczego mój kod QR skanuje się na jednym telefonie, a na innym nie?Zwykle z jednego z trzech powodów: działający telefon ma lepszą optykę aparatu, lepsze oprogramowanie do wykrywania kodów QR (nowszy system operacyjny) albo trzymasz go pod innym kątem i z innej odległości. Wypróbuj sugestie z sekcji o aparacie powyżej na tym telefonie, który nie działa.

Mój kod QR działał wczoraj, a dziś nie działa. Dlaczego?Trzy prawdopodobne przyczyny, w kolejności: (1) docelowy URL się zmienił lub zwraca błąd, (2) subskrypcja kodu dynamicznego wygasła, (3) kod został fizycznie uszkodzony.

Czy mogę naprawić statyczny kod QR bez dodruku?Samego kodu nie da się zmienić — URL jest w nim „wypalony”. Jeśli jednak kontrolujesz domenę docelowego URL-a, możesz ustawić po stronie serwera przekierowanie z oryginalnego adresu na nowy. Wydrukowany kod będzie dzięki temu nadal działał.

Dlaczego niektóre kody QR skanują się natychmiast, a inne potrzebują kilku sekund?Kody szybko skanujące się mają wyższy kontrast, lepszą jakość druku, optymalny rozmiar i rzadkie wzory danych (zwykle krótkie URL-e). Te wolniejsze mają jedną lub więcej słabości, z którymi telefon musi sobie poradzić.

Czy poziom korekcji błędów wpływa na skanowanie?Tak. Wyższa korekcja błędów (L, M, Q, H — H jest najwyższa) sprawia, że kody są bardziej odporne na uszkodzenia, ale i gęstsze. Większość generatorów domyślnie ustawia M (średni), co sprawdza się w większości przypadków. Do zastosowań zewnętrznych lub przemysłowych zaleca się Q lub H.

Czy iPhone’y skanują kody QR, których nie radzą sobie starsze Androidy?Często tak. iPhone’y generalnie mają lepsze wykrywanie kodów QR niż Androidy ze średniej półki i starsze modele. Jeśli tworzysz kody dla szerokiej publiczności, optymalizuj je pod najsłabszy rozsądny telefon w Twojej grupie odbiorców — zwykle będzie to starszy Android.

Czy kolorowe kody QR są mniej niezawodne?Nie z natury. Niezawodność zależy od kontrastu, a nie od koloru. Czarny kod i ciemnogranatowy działają równie dobrze na białym tle. Pastelowy żółty na białym — fatalnie. Przetestuj go przed użyciem.

Dlaczego mój kod działa w świetle dziennym, a nie działa pod oświetleniem w restauracji?Poziom światła wpływa na zdolność aparatu do ustawiania ostrości i postrzegany kontrast kodu. W słabym świetle aparat dłużej ustawia ostrość i widzi mniejszy kontrast niż w ciągu dnia. Większy kod, wyższy kontrast i powierzchnia, która nie błyszczy = lepsze działanie w słabym świetle.

W razie wątpliwości

Jeśli przeszedłeś przez ten przewodnik, a Twój kod nadal się nie skanuje, problemem prawie na pewno jest:

• kod wygenerowany z uszkodzonymi parametrami (rzadko, ale się zdarza — spróbuj wygenerować ponownie),
• awaria po stronie dostawcy (sprawdź stronę statusu swojego dostawcy),
• serwer docelowy jest nieaktywny albo blokuje Twój ruch.

Jeśli żaden z powyższych powodów nie pasuje, kod może mieć subtelny defekt produkcyjny. Najszybszym rozwiązaniem jest wygenerowanie kodu ponownie u sprawdzonego dostawcy i ponowny wydruk.

Utwórz nowy dynamiczny kod QR