Ошибка reCAPTCHA часто проявляется как неработающая форма: пользователь заполняет поля, нажимает кнопку, но заявка не уходит или появляется сообщение о проверке.
Причина может быть как в ключах Google, так и в JavaScript, кеше, домене, REST API, версии reCAPTCHA или серверной проверке токена.
Почему это важно
reCAPTCHA должна защищать форму от спама, но если она настроена неправильно, она блокирует реальных клиентов. Это особенно неприятно: человек готов отправить заявку, но сайт его останавливает.
Основные причины
- ключи reCAPTCHA не подходят к домену
- перепутаны v2 и v3
- скрипт Google не загружается
- кеш ломает токен
- серверная проверка возвращает ошибку
- CSP или блокировщик режет скрипты
План диагностики
- Проверить тип reCAPTCHA и ключи.
- Проверить Console и Network при отправке формы.
- Убедиться, что домен добавлен в настройках reCAPTCHA.
- Проверить, не блокирует ли скрипт кеш или CSP.
- Проверить серверный ответ проверки токена.
Что можно проверить самостоятельно
- проверить форму в другом браузере
- отключить блокировщики только для теста
- сохранить текст ошибки формы
- проверить домен в настройках ключа
- не менять сразу все антиспам-плагины
Где обычно ошибаются
- ставить несколько капч одновременно
- использовать ключи от другого домена
- не учитывать поддомены
- кешировать страницу с одноразовым токеном
Как я решаю такую задачу
Я проверяю загрузку скрипта, выдачу токена, отправку формы и серверную валидацию. Если reCAPTCHA мешает заявкам, настраиваю ее так, чтобы защита работала без блокировки нормальных пользователей.
- Фиксирую симптом, URL, время сбоя и действия, после которых появилась проблема.
- Проверяю логи, настройки сайта, интеграции и реальные запросы в браузере.
- Делаю минимальную правку, чтобы не задеть работающие разделы.
- Тестирую результат на десктопе, телефоне и в сценарии, где ошибка проявлялась.
- Передаю короткое объяснение причины и список профилактических действий.
Что подготовить для оценки
- адрес сайта или проблемной страницы
- скриншот ошибки или текст сообщения
- что меняли перед появлением проблемы
- доступ к админке, хостингу или серверу, если он нужен
- приоритет: срочно восстановить работу или спокойно разобраться в причине
Сроки
| Ключи или домен | 30-60 минут |
|---|---|
| Конфликт формы, кеша или JS | 1-2 часа |
| Кастомная серверная проверка | по коду |
Вопрос-ответ
Можно ли просто отключить reCAPTCHA?
Можно временно для проверки, но лучше настроить защиту правильно или заменить на более подходящий антиспам.
Почему ошибка только у части пользователей?
Могут влиять блокировщики, регион, браузер, кеш или разные сценарии формы.
reCAPTCHA v3 лучше v2?
Не всегда. v3 незаметна, но требует корректной обработки score и может ошибаться без настройки.
Итог
Ошибка reCAPTCHA — это баланс между защитой и конверсией. Нужно не просто включить капчу, а проверить, что она не блокирует реальные заявки.
Если нужна такая доработка или диагностика, напишите в Telegram: @rabotator_support. Посмотрю проблему, задам несколько точных вопросов и скажу, как исправить без лишней перестройки сайта.