Команда queue:failed

Команда queue:failed выводит таблицу со всеми неудачными заданиями, которые были записаны в базу данных после превышения максимального количества попыток выполнения. Эта команда помогает разработчикам отслеживать проблемы в работе очередей и находить задания, требующие ручного вмешательства или повторного запуска.

Синтаксис

php artisan queue:failed

Команда не принимает обязательных параметров и выводит информацию о всех неудачных заданиях в удобном табличном формате.

Пример

Давайте выполним команду для просмотра списка неудачных заданий:

php artisan queue:failed

Результат выполнения команды:

+----+------------+---------------------------+-------------------+-------------------+---------------+
			| ID | Connection | Queue					 | Class			 | Failed At		| Error		 |
			+----+------------+---------------------------+-------------------+-------------------+---------------+
			| 1  | database   | default				   | SendWelcomeEmail  | 2026-09-08 10:15 | Timeout	   |
			| 2  | database   | emails					| ProcessImage	  | 2026-09-08 10:20 | Connection	|
			| 3  | database   | default				   | GenerateReport	| 2026-09-08 10:25 | MemoryLimit   |
			+----+------------+---------------------------+-------------------+-------------------+---------------+

Пример с фильтрацией по подключению

Команда queue:failed поддерживает фильтрацию по конкретному подключению с помощью опции --connection:

php artisan queue:failed --connection=database

Результат выполнения команды:

+----+------------+---------+------------------+-------------------+---------------+
			| ID | Connection | Queue   | Class			| Failed At		| Error		 |
			+----+------------+---------+------------------+-------------------+---------------+
			| 1  | database   | default | SendWelcomeEmail | 2026-09-08 10:15 | Timeout	   |
			| 3  | database   | default | GenerateReport   | 2026-09-08 10:25 | MemoryLimit   |
			+----+------------+---------+------------------+-------------------+---------------+

Практическое применение

Команда часто используется в связке с другими командами для управления неудачными заданиями. Например, сначала просматриваем список:

php artisan queue:failed

Затем повторно запускаем конкретное задание по его ID:

php artisan queue:retry 1

Или удаляем все неудачные задания:

php artisan queue:flush

Смотрите также

команда queue:work,
которая запускает обработчик очереди
команда queue:retry,
которая повторно запускает неудачное задание
команда queue:listen,
которая запускает прослушиватель очереди
команда make:job,
которая создаёт новый класс задания