Как исправить ошибки установки service worker

Мы хотим, чтобы установка PushEngage WordPress прошла гладко, но вы все равно можете столкнуться с проблемами. Service worker — это ключевой файл для сбора подписчиков push-уведомлений и отправки push-кампаний.

Мы подготовили руководство с описанием различных распространенных проблем, связанных с файлом Service Worker при установке PushEngage, и способов их устранения.

Прежде чем начать

  • Следует избегать перенаправлений; так как файл service-worker.js должен быть общедоступным (https://www.mywebsite.com/service-worker.js). Если при попытке перейти по адресу файла service-worker.js происходит какое-либо перенаправление, ваша установка выполнена некорректно, и подписка также не удастся.
  • Если вы видите ошибку 403 или 404 после попытки подписаться на ваш сайт, что-то мешает файлам PushEngage Service worker быть общедоступными. Вы можете проверить это в панели управления PushEngage или в консоли браузера. Эти файлы должны быть написаны полностью заглавными буквами, а не как перенаправления. Эти страницы должны быть доступны вам без каких-либо проблем.
  • Необходимо объединить service workers, если вы интегрируете PushEngage на веб-сайт, который уже имеет service worker (например, PWA), чтобы PushEngage функционировал должным образом. Это руководство поможет вам объединить service worker PushEngage с существующим service worker на вашем веб-сайте.

Проблемы с Service worker и их решения

Ошибка 1: Неверный URL файла Service Worker

TypeError: Не удалось зарегистрировать ServiceWorker для области (https://xxxx) со скриптом (https://www). При получении скрипта был получен недопустимый код ответа HTTP (404).

Решение: Убедитесь, что имя и расположение файла Service Worker соответствуют значению из вашей панели управления PushEngage, перейдя в раздел Настройки сайта » Расширенные настройки » Настройки Service Worker

Ошибка 2: Браузер не имеет разрешения на чтение файла Service Worker

TypeError: Не удалось зарегистрировать ServiceWorker для области ('https://xxx') со скриптом ('https://xxxx'): При получении скрипта был получен недопустимый код ответа HTTP (403).

Решение: Проверьте конфигурацию веб-сервера у поставщика услуг веб-хостинга, чтобы убедиться, что конфигурация разрешает доступ на чтение к файлу Service Worker и что файл общедоступен из Интернета.

Команда PushEngage не может помочь вам с изменением разрешений, только ваша хостинговая компания или команда разработчиков может помочь вам исправить эти разрешения.

Ошибка 3: Не удалось выполнить ‘importScripts’

Uncaught DOMException: Не удалось выполнить 'importScripts' в 'WorkerGlobalScope'. Скрипт по адресу (https://xxxxxx) не удалось загрузить по адресу (https://www).

Solution:  The Service Worker file uses an incorrect subdomain name in the importScripts (https://xxxx.pushengage.com) statement inside the Service Worker file. So, ensure that the importScript statement uses the correct PushEngage subdomain assigned to the site.

The value of the domain query parameter in the Service Worker URL is incorrect. This applies only to sites using the WordPress plugin.

Error 4: Failed to register a Service Worker

DOMException: Failed to register a Service Worker for scope (https://www) with the script (https://xxxxxxxx). The path of the provided scope ('xxx') is not under the max scope allowed ('xxxxxxx'). Adjust the scope, move the Service Worker script, or use the Service-Worker-Allowed HTTP header to allow the scope.

Solution:  Move the service worker file to the root directory and update the service worker path through this guide.
After you have done that, set the value of the HTTP header Service-Worker-Allowed to ‘/’ for requests to the Service Worker file.

Если у вас возникнут какие-либо проблемы, пожалуйста, свяжитесь с нами нажав здесь. Наша служба поддержки сможет вам помочь.

Все еще не можете разобраться? Чем мы можем помочь?
Последнее обновление: 9 марта 2026 г.

Вовлекайте и удерживайте посетителей после того, как они покинули ваш веб-сайт

Увеличьте ценность каждого посещения веб-сайта с помощью push-уведомлений, которые трудно пропустить.

  • Бесплатный тариф навсегда
  • Простая настройка
  • Поддержка 5 звезд