`ScheduledTaskFailed` event is not dispatched when scheduled task is failing

[sagautam5]

Laravel Version

11.0^

PHP Version

8.4

Database Driver & Version

I am using Postgres DB

Description

I was trying to listen the laravel builtin event ScheduledTaskFailed to send notifications like email/slack etc. when scheduled command is failed in the application.

However all other events such as ScheduledTaskFinished, ScheduledTaskSkipped, ScheduledTaskStarting are dispatched correctly but ScheduledTaskFailed is not dispatched even when scheduled task is failing.

I have also looked into the implementation in framework:

try {
    $event->run($this->laravel);

    $this->dispatcher->dispatch(new ScheduledTaskFinished(
        $event,
        round(microtime(true) - $start, 2)
    ));
    
    $this->eventsRan = true;
} catch (Throwable $e) {
    $this->dispatcher->dispatch(new ScheduledTaskFailed($event, $e));

    $this->handler->report($e);
}

In this section, implementation inside catch is never executed even when failure of scheduled task.

Is there anything I am missing or misunderstood in it ?

Steps To Reproduce

1. Add following listener logic inside boot method of app service provider

use Illuminate\Console\Events\ScheduledTaskFailed;
use Illuminate\Support\Facades\Event;

Event::listen(ScheduledTaskFailed::class, function () {
    logger('Scheduled task failed');
});

2. Add example task to routes/console.php that runs every minute & fails

use Illuminate\Foundation\Inspiring;
use Illuminate\Support\Facades\Artisan;

Artisan::command('inspire', function () {
    $this->comment(Inspiring::quote());
    throw new \Exception('Inspirational quote sent!');
})->purpose('Display an inspiring quote')->everyMinute();

3. Run Scheduler
   php artisan schedule:run

Console Error:

  2025-04-10 09:55:04 Running ['artisan' inspire] .................................................................................... 774.96ms FAIL
  ⇂ '/usr/local/bin/php' 'artisan' inspire > '/dev/null' 2>&1  

But nothing logged into laravel log.

[Rahulsingh0106]

Since Laravel runs scheduled commands as a background process, exceptions don’t bubble up, and ScheduledTaskFailed is never fired.

Suggested Fix:
In ScheduledTaskFinished, if $event->task->exitCode !== 0, dispatch a synthetic ScheduledTaskFailed event manually.

if ($event->task->exitCode !== 0) {
$this->dispatcher->dispatch(new ScheduledTaskFailed(
$event->task,
new Exception("Scheduled Task exited with non-zero exit code.")
));
}

[github-actions]

Thank you for reporting this issue!

As Laravel is an open source project, we rely on the community to help us diagnose and fix issues as it is not possible to research and fix every issue reported to us via GitHub.

If possible, please make a pull request fixing the issue you have described, along with corresponding tests. All pull requests are promptly reviewed by the Laravel team.

Thank you!

[erickcomp]

I have the same issue in Laravel 12.x. I'm still making some tests, but so far, I created a Listener that handles both "ScheduledTaskFinished" and "ScheduledTaskFinished" and in the handler, I test the exit code for non-success to do the proper error handling. Something like this:

public function handle(ScheduledTaskFinished|ScheduledTaskFailed $event,): void
{
    if ($event instanceof ScheduledTaskFailed || $event->task->exitCode != 0) {
        $this->handleFail($event);
    }
}

protected function handleFail($event)
{
    //...
}

[sagautam5]

@erickcomp In my case, ScheduledTaskFailed was not fired but ScheduledTaskFinished was fired correctly. In successful completion of scheduled task there is no issue !

[erickcomp]

@erickcomp In my case, ScheduledTaskFailed was not fired but ScheduledTaskFinished was fired correctly. In successful completion of scheduled task there is no issue !

In my case, the ScheduledTaskFinished is being fired on failure and has exit code !== 0

[sagautam5]

@erickcomp what the laravel version you are using, is it 12.x ?

[erickcomp]

@sagautam5 . Yup, it's 12.3.

[sagautam5]

@erickcomp This means issue is on version 11.x and has been fixed on laravel 12.x, right ?

[erickcomp]

@sagautam5 No, it does not. ScheduledTaskFailed is not being fired on 12.x. I put it in my code in case it gets fixed, but right now I'm relying only on the exit code
.

[achrafAa]

Hey 👋 I’ve created a PR to resolve this issue by ensuring the ScheduledTaskFailed event is dispatched for all failure cases — including exceptions, non-zero exit codes, and background/system-level failures.

PR: #https://github.com/laravel/framework/pull/55551

This should make failure handling much more consistent for monitoring, alerts, and debugging workflows. Let me know if any adjustments are needed! ✅

[sagautam5]

@achrafAa it seems this will fix my issue, hopefully it will get merged very soon !