Laravel队列执行成功却报超时与重试次数过多错误排查

核心问题拆解 #

任务实际执行完成，但被标记为失败并触发告警，根源在于两个关键超时配置不匹配：

• PHP全局执行超时限制（默认60秒）触发致命错误
• AWS SQS的可见性超时设置过短，队列误判任务超时失败，Worker却仍在执行已取出的任务

1. 调整PHP全局执行超时 #

日志中的Maximum execution time of 60 seconds exceeded是PHP的max_execution_time限制导致的，和Laravel Job的$timeout参数无关。

解决方法： #

• 修改服务器php.ini文件：

  max_execution_time = 1800 ; 和Job、Supervisor的超时保持一致
  

• 若使用AWS Elastic Beanstalk，通过.ebextensions配置文件修改：

  files:
    "/etc/php.d/99-custom.ini":
      mode: "000644"
      owner: root
      group: root
      content: |
        max_execution_time = 1800
  

• 重启服务生效：

  sudo systemctl restart php-fpm
  sudo supervisorctl restart sqs-worker:*
  

2. 配置AWS SQS队列的可见性超时 #

这是最关键的修复点：SQS的可见性超时必须大于等于任务实际执行时间。如果该值过短，SQS会把未完成的任务重新放回队列，而你的--tries=1配置会直接标记任务失败，同时Worker还在继续执行已取出的任务。

解决方法： #

1. 登录AWS控制台，找到目标SQS队列
2. 进入「配置」→「可见性超时」，设置为1800秒（30分钟）（和Job/Supervisor超时一致）
3. 保存配置

注：SQS可见性超时最大支持12小时，可根据任务实际执行时长灵活调整。

3. 优化任务性能（从根源缩短执行时间） #

当前任务处理15000+条数据时，逐条save()、重复全量查询等操作严重拖慢执行效率，需针对性优化：

（1）批量插入数据 #

替换逐条save()为批量插入，大幅减少数据库交互次数：

// 替换原foreach循环逻辑
$batchData = [];
foreach($apps as $app) {
    $batchData[] = [
        'client_id' => $app->client_id,
        'name' => $app->name,
        'booking' => $app->booking->name,
        'price' => $app->price + $app->discount + $app->gst,
        'created_at' => now(),
        'updated_at' => now(),
    ];
    // 每1000条批量插入一次，避免内存溢出
    if (count($batchData) >= 1000) {
        ApplicationTable::insert($batchData);
        $batchData = [];
        Log::info('Inserted 1000 records');
    }
}
// 插入剩余数据
if (!empty($batchData)) {
    ApplicationTable::insert($batchData);
}

（2）避免重复全量查询 #

生成Excel时无需重新查询ApplicationTable，直接复用已获取的$apps数据：

// 替换原$lists查询逻辑
$exportData = $apps->map(function($app) {
    return [
        'client_id' => $app->client_id,
        'name' => $app->name,
        'booking' => $app->booking->name,
        'price' => $app->price + $app->discount + $app->gst,
    ];
});
(new ReportExport($exportData))->store('application_report');

（3）预加载关联模型 #

查询$apps时预加载booking和user关联，避免N+1查询：

$apps = Application::with(['booking', 'user'])
    ->where('client_id', $id)
    ->get();

4. 确认配置一致性 #

确保所有超时配置保持统一：

• Job类中的public $timeout = 1800;
• Supervisor命令中的--timeout=1800
• PHP的max_execution_time = 1800
• SQS队列的可见性超时 = 1800秒（或更长）

验证方法 #

修改配置后重新触发任务，观察日志：

• 无60秒超时错误
• 任务完成后未被记录到failed_jobs表
• 告警邮件不再触发

内容的提问来源于stack exchange，提问作者Nazhan Nasir