reCAPTCHA nie działa: krok po kroku naprawy dla każdego użytkownika

Przewodnik omawia przyczyny problemów z reCAPTCHA oraz wskazówki, jak je rozwiązać, obejmując kwestie przeglądarek, sieci i integracji.

Jeśli reCAPTCHA nie działa na Twojej stronie internetowej lub w przeglądarce, prawdopodobnie jest to spowodowane problemami z przeglądarką, ograniczeniami sieciowymi lub błędami w integracji. Ten przewodnik przekształca najczęstsze objawy i rozwiązania, od podstawowych ustawień przeglądarki po zaawansowane rozwiązywanie problemów dla programistów.

Jak naprawić reCAPTCHA, która nie działa

1. reCAPTCHA nie ładuje się lub kręci się

Co się dzieje:

Okno reCAPTCHA się nie pojawia, lub widzisz tylko ikonę ładowania.

Rozwiązanie dla użytkowników:

• Zaktualizuj przeglądarkę do najnowszej wersji (Google obsługuje tylko dwie ostatnie wersje głównych przeglądarek).
• Włącz JavaScript i ciasteczka w ustawieniach przeglądarki.
• Wyłącz blokery reklam, takie jak Ghostery lub uBlock, tymczasowo lub dodaj do białej listy domeny Google.
• Wyczyść pamięć podręczną przeglądarki lub otwórz stronę w trybie incognito.
• Przełącz sieci lub użyj VPN, jeśli jesteś za zaporą lub w kraju, w którym domeny Google są zablokowane.
• Jeśli nie jesteś pewien, które przeglądarki obsługują CAPTCHA poprawnie, sprawdź tę pełną listę obsługi przeglądarek dla reCAPTCHA, aby zapewnić kompatybilność.

Rozwiązanie dla programistów:

• Dołącz poprawny skrypt:
  <script src="https://www.google.com/recaptcha/api.js" async defer></script>
  lub dla v3:
  <script src="https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY"></script>
• Upewnij się, że widget nie jest w ukrytych elementach lub modalach przed renderowaniem.
• Wywołaj grecaptcha.reset() po wyświetleniu ukrytego widgetu.
• Zaktualizuj politykę bezpieczeństwa treści, aby zezwolić na:
  • https://www.google.com/recaptcha/
  • https://www.gstatic.com/recaptcha/
• Użyj https://www.recaptcha.net/recaptcha/api.js, jeśli Google jest zablokowane w Twoim regionie.
• Dodaj "localhost" do dozwolonych domen klucza podczas testowania lokalnie.

2. "Nie można połączyć z usługą reCAPTCHA"

Co się dzieje:

Otrzymujesz komunikat o błędzie informujący, że reCAPTCHA nie mogła się załadować z powodu problemów z połączeniem.

Rozwiązanie dla użytkowników:

• Sprawdź swoje połączenie internetowe i upewnij się, że www.google.com jest dostępne.
• Przełącz na inną sieć (Wi-Fi lub GSM).
• Spróbuj w innej przeglądarce lub urządzeniu.
• Jeśli w aplikacji lub osadzonej widoku, aplikacja może potrzebować włączyć pamięć DOM lub zaktualizować dozwolone domeny.

Rozwiązanie dla programistów:

• Sprawdź konsolę przeglądarki pod kątem BROWSER_ERROR lub innych błędów sieciowych.
• Powtórz wykonanie reCAPTCHA, jeśli sieć zawiedzie.
• W Android WebView włącz pamięć DOM:
  settings.setDomStorageEnabled(true);
• Aby uniknąć błędów mieszanej zawartości, używaj HTTPS wszędzie.
• Sprawdź czas systemowy—weryfikacja SSL nie powiedzie się, jeśli zegar urządzenia jest błędny.
• Dodaj localhost do białej listy w panelu administracyjnym Google podczas testowania.

3. Nieprawidłowa domena dla klucza strony

Co się dzieje:

Widoczny komunikat: BŁĄD dla właściciela strony: Nieprawidłowa domena dla klucza strony.

Rozwiązanie dla programistów:

• Zaloguj się do konsoli administracyjnej Google reCAPTCHA.
• Dodaj domenę...

poprawne nazwy domen (np. example.com i www.example.com) — nie należy dodawać http://.

• Użyj klucza v2 dla checkbox/invisible, oraz klucza v3 dla widgetów opartych na punktacji. Nie mieszaj ich.
• Jeśli to konieczne, wygeneruj nowy klucz i zaktualizuj go w swoim kodzie.

Naprawa dla Użytkowników:

• Jeśli to się zdarza na stronie trzeciej, to nie Twoja wina. Możesz spróbować uzyskać dostęp do wersji www lub non-www adresu URL lub skontaktować się z obsługą strony.

4. “Nieprawidłowy klucz strony” lub “Nieprawidłowy typ klucza”

Co się dzieje:

Widget wydaje się być uszkodzony lub natychmiastowo zwraca błędy związane z kluczem.

Naprawa dla Programistów:

• Upewnij się, że klucz strony odpowiada wersji widgetu.
  • Klucze v2 działają tylko z widgetami v2.
  • Klucze v3 działają tylko z API v3.
  • Klucze Enterprise wymagają specjalnych wywołań API.
• Nie myl klucza strony z kluczem tajnym — każdy jest umieszczony w innym miejscu (frontend vs backend).
• Jeśli Twój klucz został dezaktywowany lub zmieniłeś typy, wygeneruj nowy klucz i zamień go w swojej konfiguracji.

Naprawa dla Użytkowników:

• To jest problem po stronie programisty. Możesz spróbować odświeżyć, ale jeśli używany klucz jest błędny, może to naprawić tylko właściciel strony.

5. reCAPTCHA zawsze nie przechodzi weryfikacji

Co się dzieje:

Ukończysz CAPTCHA, ale formularz nadal się nie wysyła lub mówi, że weryfikacja nie powiodła się.

Naprawa dla Programistów:

• Sprawdź swoją żądanie POST po stronie serwera do:
  https://www.google.com/recaptcha/api/siteverify
• Uwzględnij oba:
  • secret: Twój klucz tajny
  • response: token g-recaptcha-response użytkownika (pole formularza)
• Nie konwertuj żądania na ciąg znaków. Użyj standardowego formatu application/x-www-form-urlencoded.
• Jeśli używasz reCAPTCHA v3:
  • Dostosuj próg punktacji. Niektórzy użytkownicy mogą otrzymać niską punktację (<0.5) i zostać zablokowani.
  • Jeśli zobaczysz “Przekroczono bezpłatny limit” przy wysokich punktach, oznacza to, że wykorzystanie przekroczyło limity.

Naprawa dla Użytkowników:

• Spróbuj rozwiązać CAPTCHA używając alternatywy audio.
• Wyczyść pamięć podręczną przeglądarki lub przełącz się na inną przeglądarkę.
• Jeśli problem nadal występuje, zgłoś to do zespołu wsparcia strony.

6. “Twój komputer lub sieć może wysyłać automatyczne zapytania”

Co się dzieje:

Google oznacza Twoje połączenie jako podejrzane.

Naprawa dla Użytkowników:

• Przełącz się na inną sieć lub rozłącz się z VPN/proxy.
• Poczekaj kilka godzin — limity prędkości są zazwyczaj tymczasowe.
• Jeśli zostaniesz o to poproszony, ukończ wyzwania CAPTCHA, aby udowodnić, że jesteś człowiekiem.

Naprawa dla Programistów:

• Sprawdź, czy wywołujesz pętle, które wielokrotnie ładują CAPTCHA.
• Jeśli wielu użytkowników zgłasza ten problem, zasugeruj im zmianę adresów IP lub sprawdź, czy Twoja domena nie jest oznaczana przez Google.

Najczęściej zadawane pytania

Dlaczego reCAPTCHA nie wyświetla się w mojej przeglądarce?

Może to być spowodowane blokadami reklam, przestarzałą przeglądarką, wyłączonym JavaScriptem lub ograniczeniami sieciowymi.

Jak naprawić błąd “Nieprawidłowy klucz strony”?

Tak. Wystarczy dodać localhost do białej listy w panelu administracyjnym Google reCAPTCHA podczas tworzenia lub edytowania klucza.

Jaka jest różnica między reCAPTCHA v2 a v3?

v2 pokazuje checkbox lub wyzwanie. v3 ocenia interakcję w tle i nie wymaga interakcji użytkownika.

Czy reCAPTCHA działa w trybie incognito?

Tak, ale blokady reklam lub surowsze ustawienia prywatności w trybie incognito mogą interferować z ładowaniem skryptów.

Konkluzja

Kiedy reCAPTCHA nie działa, problem często leży w ustawieniach przeglądarki, ograniczeniach sieciowych lub błędnie skonfigurowanych kluczach witryny. Dla użytkowników rozwiązanie może być tak proste, jak wyłączenie rozszerzeń lub aktualizacja przeglądarki. Dla programistów kluczowe jest przeglądanie szczegółów integracji, ustawień domeny i wersji API. Jeśli błędy się utrzymują, dokumentacja wsparcia Google oraz konsola administracyjna oferują ostatnie narzędzia do rozwiązania problemu.

Jeśli ciekawią Cię artykuły podobne do reCAPTCHA nie działa: krok po kroku naprawy dla każdego użytkownika, zajrzyj do kategorii Tutoriale i odkryj jeszcze więcej interesujących treści.