#Что означает ошибка
Агенты не выполняются
Для стабильной работы агентов переведите их на cron: отключите выполнение на хите и добавьте задание cron_events.php.
#Причины и признаки
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Выполнение на хите | Прочитайте относящуюся к этому компоненту запись в журнале до изменения конфигурации. | Cron. |
| Нет cron | Не работает. Прочитайте относящуюся к этому компоненту запись в журнале до изменения конфигурации. | Добавьте. |
| Неверный путь | Сверьте точное имя и расположение файла; попробуйте действие на копии без изменения исходника. | Исправьте. |
| Права | Сравните полномочия текущей учётной записи и доступность нужной функции; на рабочем компьютере политики задаёт администратор. | Проверьте. Посмотрите соответствующие настройки и журнал сервиса. |
#Пошаговое решение
- Отключите агенты на хитеВ административной панели Битрикс найдите раздел с агентами и настройками их выполнения (в разных редакциях/версиях путь отличается). Проверьте, не выполняются ли агенты на хитах и есть ли утверждённая схема выполнения по cron. Не выключайте выполнение на посетителях, пока не настроен альтернативный запуск: иначе задачи сайта остановятся.
- Добавьте cronВ панели хостинга откройте «Планировщик заданий/Cron» и создайте задание по официальной инструкции вашей версии Битрикс, указывая полный путь к нужному PHP CLI и штатному скрипту запуска агентов. Не используйте в cron веб-URL с секретами и не запускайте несколько копий одновременно без механизма блокировки.
- Проверьте журналВ настройке задания направьте stdout/stderr в защищённый журнал и проверьте время запуска, путь к интерпретатору, рабочую директорию и пользователя. Сначала вручную выполните ту же команду с теми же правами в тестовой среде; затем убедитесь, что агент изменил статус/время следующего запуска.
- Проверьте альтернативу: праваЕсли cron запускается, но агент падает, проверьте доступность БД, права чтения к файлам, версию PHP CLI и исключения в журнале. Не давайте cron права root ради обхода: используйте учётную запись сайта и исправьте конкретное ограничение. После настройки проверьте отсутствие пропущенных задач и дублей.
#Проверка результата
Для «1С-Битрикс: агенты не выполняются — настройка cron» выполните штатную проверку конфигурации, затем один контрольный запрос к сервису. Сверьте его результат с журналом и убедитесь, что пользователи не получили новых ответов 4xx или 5xx после изменения.