Checklist
| Verificação | Detalhe |
|---|---|
| O cron existe? | Uma linha que executa php artisan schedule:run a cada minuto, no usuário certo |
| Caminho e versão do PHP | O cron pode usar um executável do PHP diferente do usado pelo site |
| As tarefas estão registradas? | schedule:list mostra o que está agendado e quando roda |
| Trava presa | Tarefas com withoutOverlapping podem ficar bloqueadas se uma execução foi interrompida |
| Fuso horário | Tarefas rodando em horário diferente do esperado |
| Restrição de ambiente | Tarefas configuradas para rodar só em certos ambientes |
| Erros na tarefa | A tarefa roda, mas falha; veja os logs |
Depois de trocar de servidor
O cron não faz parte do código: ele fica configurado no servidor. Ao migrar, ele precisa ser recriado. É uma das falhas mais comuns em mudanças de hospedagem. Veja como mudar um sistema de servidor.
Evite falhas silenciosas
- Registre o início e o fim de cada tarefa importante
- Configure aviso em caso de falha (e-mail, mensagem, ferramenta de monitoramento)
- Use serviços de verificação que alertam quando uma tarefa não roda no horário
- Tarefas longas devem enviar o trabalho para a fila, em vez de rodar no agendador
Leia também
Se as tarefas agendadas usam filas, veja filas do Laravel não processam. Para evitar que a falha passe despercebida, veja manutenção preventiva. Corrigimos agendamentos no nosso serviço de manutenção de sistemas PHP e Laravel.