В Webasyst не выполняется cron: как проверить задания, PHP и журналы

В интернет-магазине перестали обновляться остатки поставщика, отложенные операции выполняются только вручную или периодическая очистка вообще не запускается. Ошибка может находиться не в самом обмене, а в расписании, команде запуска, окружении PHP или обработчике задания. Главное — разделить два вопроса: был ли вызван скрипт и завершил ли он полезную работу.

Ниже приведён порядок диагностики для Webasyst и Shop-Script на сервере, к которому есть разрешённый административный доступ. Конкретные команды зависят от приложения, плагина, версии платформы и выбранного способа запуска; менять расписание рабочего магазина до проверки не стоит.

1. Уточните тип планировщика и само задание

В Webasyst возможны разные схемы запуска. Обычный системный cron вызывает PHP-скрипт через командную строку сервера. Для разработчиков также описан сервис Webasyst Cron: он отправляет запросы для выполнения специально реализованных заданий и требует активного подключения к Webasyst ID. У этих механизмов отличаются регистрация, точка входа и диагностика; нельзя автоматически переносить команду одного механизма в другой.

Сначала запишите название функции, приложение или плагин, ожидаемую периодичность и ответственную систему. Проверьте, должен ли обмен запускаться по cron вообще: некоторые интеграции работают по вебхукам, событиям, очередям или внешнему расписанию. Полезны официальное описание CLI-заданий и документация Webasyst Cron.

2. Зафиксируйте, что именно перестало обновляться

Возьмите один проверяемый показатель: время последнего успешного импорта, идентификатор обработанного файла, число обновлённых SKU или отметку завершения операции в журнале. Сравните ожидаемое расписание и реальные события с учётом часового пояса сервера и настроек приложения. Время редактирования карточки товара не всегда доказывает факт запуска нужного скрипта.

Уточните момент появления сбоя: после смены хостинга, версии PHP, обновления плагина, изменения пути проекта или без видимых изменений. Если одновременно перестали работать все задания, сначала проверяйте общий планировщик. Если отказала только одна интеграция, важнее её команда, журнал и обработчик.

3. Проверьте запись cron и путь до PHP

В панели хостинга или доступном системном расписании найдите конкретное задание. Сверьте частоту, включённость, пользователя запуска, абсолютный путь к интерпретатору PHP и полный путь к корневому файлу Webasyst. Для классических CLI-действий документация показывает схему php /path/to/webasyst/cli.php app action; для специализированных плагинов идентификаторы команды могут отличаться. Не подставляйте пример буквально вместо команды вашего плагина.

Расписание вида */10 * * * * означает попытку запуска раз в десять минут, но не успешное завершение каждой попытки. Удостоверьтесь, что задание не было отключено хостером, что в расписании нет устаревшего пути после переезда и что PHP запускается той версией, с которой совместим установленный код. Не меняйте глобальную версию PHP ради одного cron без тестов сайта.

4. Разделите ошибки запуска и ошибки кода

На тестовой копии или в согласованное безопасное окно выполните ту же команду от соответствующего пользователя и запишите код завершения, стандартный вывод и ошибки. Важно использовать именно PHP CLI, а не ориентироваться исключительно на настройки PHP для веб-запросов: различия версий и расширений способны привести к ситуации, когда административная панель работает, а скрипт падает.

Проверьте рабочую директорию, доступность файлов, разрешения на запись в журналы и временные каталоги, необходимые расширения, ограничения памяти и сетевую доступность внешнего API. Сообщение «class not found» указывает на загрузку обработчика или неправильное имя действия; таймаут после подключения к внешнему сервису — на другую ветку диагностики. Отсутствие текста в консоли само по себе не означает успех: некоторые обработчики ничего не выводят.

5. Найдите след выполнения в журналах

Проверяйте несколько уровней: журнал самого cron или панели хостинга, серверный вывод ошибок PHP, журнал Webasyst и собственный лог интеграции, если он предусмотрен. Сопоставляйте записи по времени и идентификатору задания, а не только по похожим текстам ошибок. Для сложных обменов полезен единый идентификатор запуска, который проходит через запись старта, этапы и итоговый результат.

Если событие старта есть, а завершения нет, проверьте зависание внешнего запроса, превышение времени выполнения, блокировки базы или нехватку ресурсов. Если задание завершилось с кодом ноль, но данные не изменились, возможно, фильтр отбора вернул пустую выборку, все позиции были пропущены или внешний сервис отклонил часть запросов. Пароли, токены и персональные данные в журнал не записывайте.

6. Проверьте конфигурацию Webasyst Cron отдельно

Если продукт использует сервис Webasyst Cron, найдите его фактическое задание и регистрацию в предусмотренных разработчиком настройках. В официальной документации описаны конфигурация lib/config/cron.php, классы заданий и операции управления расписанием. Это другой механизм, чем простой вызов произвольного .cli.php из системного crontab. Проверьте состояние подключения к Webasyst ID и то, дошёл ли вызов до обработчика.

Не включайте параллельно системный cron и Webasyst Cron для одной и той же бизнес-операции без понимания логики продукта. Двойной запуск может привести к повторным отправкам, конкурентным обновлениям или конфликтам блокировок, даже если каждый механизм отдельно работает правильно.

7. Восстановите обработку без повторного создания данных

Перед повторным запуском определите, что успела сделать предыдущая попытка. Импорт каталога может обновить половину SKU, отправка заказов — передать часть документов, а выгрузка — оставить незавершённую очередь. Полный повтор «с нуля» без проверки сопоставления ID и состояния пакета способен создать дубли либо перезаписать новые данные старыми.

Начните с ограниченной выборки. Проверьте, поддерживаются ли безопасные повторы, контроль уже обработанных записей, блокировка одновременных запусков и сохранение точки продолжения. Для регулярного обмена ценами и остатками это часть интеграции с поставщиками в Shop-Script, а не только настройка одной строки расписания.

8. Проверьте исправление в течение нескольких циклов

После внесения одного согласованного изменения зафиксируйте время запуска, результат, число обработанных объектов и отсутствие повторов. Дождитесь нескольких штатных циклов: успешный ручной запуск не доказывает, что расписание, пользователь и окружение cron настроены верно. Если нагрузка растёт, оцените дробление больших заданий, ограничение частоты обращений к API и уведомление об ошибках.

Полезно задать простые контрольные показатели: сколько времени прошло с последнего успешного выполнения, каков объём необработанной очереди и сколько последовательных попыток завершилось ошибкой. Для систематического разбора сбоев можно организовать техническую поддержку магазина, а для исправления проблемной логики — доработку плагина Webasyst после анализа реального кода.

Итог: проверяйте цепочку, а не только расписание

Рабочий cron — это связка «запись в планировщике → запуск корректного PHP → загрузка нужного обработчика → выполнение логики → проверяемый результат». На каждом участке сохраняйте отдельное доказательство. Такой подход помогает найти причину без опасных массовых повторов, а дальнейший мониторинг позволяет заметить остановку обмена до того, как ошибочные цены и остатки попадут к покупателям.