Crontab не выполняется: почему задача не запускается и что исправить
Задача в crontab не выполняется, когда cron её не запускает или запускает в другом окружении, чем ваша консоль. Сначала проверьте, доходит ли запуск до cron: grep CRON /var/log/syslog или journalctl -u cron. Если запись о запуске есть, проблема в самой команде, её путях и правах.
01Другое окружение и PATH
cron запускает команды через /bin/sh с урезанным окружением, PATH=/usr/bin:/bin. Команда, которая работает в консоли, может не найти php, node или composer, если они лежат в /usr/local/bin. Проверить это просто: запустите ту же строку вручную через env -i /bin/sh -c 'команда'. Пишите полные пути к бинарникам, например /usr/bin/php.
crontab -l
env -i /bin/sh -c '/usr/bin/php /var/www/example.com/artisan schedule:run'
02Нет прав у пользователя таблицы
Каждая таблица crontab принадлежит своему пользователю, и команды в ней выполняются от его имени. Если задача пишет в /var/www/example.com/storage или читает .env, у этого пользователя должны быть права на файлы. Проверьте, от кого идёт запуск: sudo crontab -u www-data -l. Для задач сайта правьте таблицу www-data через sudo crontab -u www-data -e, а не таблицу root.
sudo crontab -u www-data -l
sudo crontab -u www-data -e
03Неэкранированный % в команде
В crontab символ % означает перевод строки, поэтому date +%Y-%m-%d обрежется до date +. Экранируйте каждый процент обратной косой чертой: \%. Это частая причина, когда задача с датой или форматом логов молча ничего не делает.
* * * * * /bin/date '+\%Y-\%m-\%d' >> /var/log/job.log 2>&1
04Файл в /etc/cron.d без перевода строки или с точкой в имени
Файлы в /etc/cron.d/ читает сам cron, и формат у них другой: между расписанием и командой есть поле пользователя. Если в конце файла нет перевода строки, последняя строка игнорируется. Имя файла с точкой, например my.job, cron пропускает: используйте только буквы, цифры, дефис и подчёркивание. Проверьте файл через cat -A: конец строки должен быть $.
cat -A /etc/cron.d/example
# формат: минута час день месяц день_недели пользователь команда
* * * * * www-data /usr/bin/php /var/www/example.com/artisan schedule:run >> /var/log/job.log 2>&1
05Вывод теряется, и непонятно, была ли задача
cron отправляет вывод команды почтой, а на сервере без почтового агента он пропадает. Без перенаправления вы не увидите ни ошибки, ни признака запуска. Допишите >> /var/log/job.log 2>&1 и смотрите файл после ожидаемого времени. Заодно проверьте, что каталог для лога существует и доступен пользователю таблицы.
* * * * * /usr/bin/php /var/www/example.com/artisan schedule:run >> /var/log/job.log 2>&1
tail -n 50 /var/log/job.log
06Часовой пояс системы
cron работает по часовому поясу системы, а не по поясу в приложении. Если после смены пояса через sudo timedatectl set-timezone задача срабатывает не в то время, перезапустите службу: sudo systemctl restart cron. Проверьте текущий пояс командой timedatectl.
timedatectl
sudo timedatectl set-timezone Europe/Moscow
sudo systemctl restart cron
07Как убедиться, что ошибка ушла
Дождитесь ближайшего запуска и проверьте журнал: grep CRON /var/log/syslog или journalctl -u cron. В логе должна быть строка с вашей командой, а в /var/log/job.log свежий вывод. Для задачи Laravel убедитесь, что строка ровно одна: * * * * * cd /var/www/example.com && php artisan schedule:run >> /dev/null 2>&1. Дублирующиеся строки дают двойной запуск задач.
grep CRON /var/log/syslog
journalctl -u cron --since '10 min ago'
crontab -l
Что не помогает
-
Править файлы в
/var/spool/cron/crontabs/руками.Эти файлы принадлежат cron, правьте таблицу через
crontab -eилиsudo crontab -u www-data -e. -
Добавлять задачу в
/etc/crontabбез поля пользователя.В
/etc/crontabи/etc/cron.d/*между расписанием и командой указывается пользователь, иначе строка не разберётся. -
Перезапускать cron после каждой правки таблицы.
Таблицы пользователей cron перечитывает сам, перезапуск
sudo systemctl restart cronнужен только после смены часового пояса. -
Оставлять команду без перенаправления вывода и искать ошибку в консоли.
Допишите
>> /var/log/job.log 2>&1и смотрите файл: без почты вывод команды теряется.
Deploykin
Как это делается в Deploykin
В Deploykin демоны Supervisor создаются из панели, и там же видно их состояние: работает, падает при старте или остановлен. Вывод каждого демона пишется в свой лог и читается в панели, а если воркер упал и Supervisor не смог его поднять, придёт оповещение.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Почему команда работает в консоли, но не в cron?
У cron другое окружение и PATH=/usr/bin:/bin. Укажите полный путь к бинарнику и проверьте запуск через env -i /bin/sh -c 'команда'.
Как узнать, запускался ли cron вообще?
Смотрите grep CRON /var/log/syslog или journalctl -u cron. Если записи о запуске нет, cron не разобрал строку или не видит файл.
Почему задача в /etc/cron.d не срабатывает?
Проверьте поле пользователя, перевод строки в конце файла и имя без точки. Файл с точкой в имени cron пропускает.
Нужно ли перезапускать cron после crontab -e?
Нет, таблицы пользователей cron перечитывает сам. Перезапуск нужен после смены часового пояса системы.
Ещё по теме
- Ошибка · Cron Supervisor не запускается: ошибки, причины и исправление Почему Supervisor не запускается и supervisorctl не работает: проверка конфига, права, логи, команды reread и update, настройка program в ini.
- Руководство · Cron crontab guru: как читать формат crontab и настроить задание Разбираем формат crontab по полям, показываем команды crontab -e и crontab -l, проверку через syslog и типичные ошибки при настройке cron на Ubuntu 24.04.
- Конфиг · Cron Crontab: примеры расписаний и как их применить Готовый crontab с примерами расписаний: каждые 5 минут, каждый час, по будням, @reboot. Как применить через crontab -e и проверить по /var/log/syslog.
- Руководство · Cron Настройка cron для Bitrix на Ubuntu 24.04 Как настроить cron для Bitrix на Ubuntu 24.04: таблица пользователя www-data, запуск агентов и почтовой очереди, полные пути, логи и проверка выполнения.
- Руководство · Cron Как настроить cron каждые 5 минут на Ubuntu 24.04 Как настроить задание cron каждые 5 минут на Ubuntu 24.04: строка crontab, полные пути, логирование вывода и проверка запусков по syslog.
- Руководство · Cron Настройка crontab на Ubuntu 24.04: от расписания до проверки Пошаговая настройка crontab на Ubuntu 24.04: синтаксис расписания, запуск скрипта каждый час, права www-data, проверка через syslog и типичные ошибки.