如何解决AWS Lambda/SQS架构下的504网关超时问题？

我有一个基于Laravel/PHP开发的应用，部署在AWS API Gateway/Lambda无服务器架构上。因某任务处理耗时较长，使用SQS进行队列管理。该任务需调用外部API上传文档并获取签名文档，但同时发送5份及以上文档时，日志中出现504 Gateway Timeout错误，无法获取签名文档。我使用Guzzle发起请求，已设置'timeout' => 120，任务耗时约48秒。

Lambda日志显示：

REPORT RequestId: xxxx-xx-xxxx-x-xxxDuration: 47.69 ms Billed Duration: 48 ms Memory Size: 1024 MB Max Memory Used: 78 MB Init Duration: 399.67 ms

1. 曾看到说法：即便AWS网关超时为30秒，将任务放入SQS就不会有问题，该说法是否正确？
2. 该如何解决当前问题？

实际任务耗时超30秒，但放入队列后仍出问题，这是为何？我使用Laravel Saloon库发起HTTP请求，任务代码如下：

<?php

namespace App\Jobs;


use App\Http\Saloon\Requests\CreateModuleJob;
use App\Models\Integration;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Arr;

class CreateModuleJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public function __construct(         
        public array $information,
        public string $module_id,

    ) {
    }

    /**
     * Execute the job.
     *
     * @return void
     */
    public function handle()
    {           

        $request = new CreateModuleRequest($this->information);

       ///here takes more than 30 seconds  
        $response = $request->sendAsync()->then(
            function ($response) {
                //emit webhook 
            },
            function ($response) {
                //emit webhook
            }
        );

        $response->wait();
    }    
   
}

我使用spatie webhook库发送Webhook，由Node应用接收，Lambda日志返回包含504错误的响应。请问任务中耗时超30秒的请求是否是问题根源？即便放入SQS也会受影响？

调用外部API前，Lambda会先请求转发服务器（因外部API仅接受特定IP的请求），超时是来自Lambda还是转发服务器？

关于“SQS规避API Gateway超时”的说法是否正确？ #

这个说法不完全准确。API Gateway的30秒超时针对的是直接通过网关触发的同步请求，SQS队列任务由Lambda异步消费，确实不受API Gateway超时限制，但Lambda本身有执行超时上限（默认3秒，最大可配置至15分钟）。只要Lambda超时配置超过任务实际耗时，SQS异步逻辑本身不会因API Gateway的30秒限制报错。

当前问题的根源分析 #

1. Lambda超时配置不足：从日志看，任务Duration仅47.69ms，远低于实际48秒耗时，说明Lambda可能因超时设置过小被提前终止，直接触发504错误。
2. Saloon异步请求误用：sendAsync()+wait()本质还是同步阻塞等待，和直接用同步请求无区别。若外部API单请求耗时超30秒，且Lambda超时配置不足，必然触发超时。
3. 转发服务器瓶颈：同时处理5份及以上文档时，转发服务器可能因并发限制、资源不足或自身超时设置（比如对外部API请求超时设为30秒），导致请求失败返回504。
4. Webhook环节干扰：Lambda日志中的504也可能来自Webhook接收方（Node应用）的处理超时，需结合日志上下文判断。

解决步骤 #

1. 调整Lambda超时配置：在AWS控制台将Lambda执行超时设为大于任务实际耗时（比如60秒），确保任务能完整执行。
2. 优化Saloon请求逻辑：
   • 若无需同步等待结果，去掉wait()，将Webhook逻辑放到Promise回调中，避免阻塞Lambda；
   • 若必须同步等待，在CreateModuleRequest中显式设置超时：protected int $timeout = 120;，确保覆盖Guzzle配置。
3. 排查转发服务器：
   • 检查转发服务器的并发连接数限制，是否因高并发导致资源耗尽；
   • 确认转发服务器对外部API的请求超时设置，确保大于48秒；
   • 查看转发服务器日志，确认是否是它返回的504错误。
4. 控制队列并发：在Laravel队列配置中，限制SQS队列的并发处理数（比如queue:work --max-concurrent-jobs=3），避免过多请求压垮转发服务器或外部API。

补充疑问解答 #

超时来源需结合日志定位：

• 若Lambda日志显示任务执行时间接近Lambda超时配置，说明是Lambda超时；
• 若转发服务器有独立日志且记录了超时，说明是转发服务器返回的504；
• 在Lambda中添加请求生命周期日志（记录转发请求的开始、结束时间及响应状态），可精准定位超时环节。

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