使用Google Cloud Tasks SDK设置dispatchDeadline不生效，任务始终以600秒超时

遇到过一模一样的坑！我来分享下整个排查和解决的过程：

问题场景 #

我们用PHP 8.3配合Google Cloud相关依赖（其中google/cloud-tasks版本为^1.15），通过SDK创建Cloud Tasks任务时，明确设置了dispatchDeadline为1800秒（符合官方文档里HTTP请求任务的最大限制）：

$tasca->setDispatchDeadline((new \Google\Protobuf\Duration())->setSeconds(1800));

甚至尝试过直接传字符串替代Duration对象，但不管怎么操作，任务总是在600秒就触发超时。后来用API Explorer创建任务，返回结果里明明显示dispatchDeadline是1800s，可实际运行时还是会在600秒超时。

排查过程 #

1. 先排除SDK和API调用问题：不管是SDK的传参方式，还是直接调用官方API Explorer，任务创建后的返回都显示dispatchDeadline正确设置为1800秒，说明Cloud Tasks这边的配置是生效的。
2. 对比不同超时场景的错误：测试CGI(FPM)超时的时候，任务错误显示为“UNKNOWN”；而当前的超时错误和Nginx返回504网关超时的表现完全一致。
3. 检查后端服务器配置：最终发现是Nginx服务器设置了600秒的超时时间，它会在请求达到600秒时直接返回504，而Cloud Tasks收到这个504响应后，会判定为任务超时，两者的错误提示高度相似，才误导我们以为是Cloud Tasks的dispatchDeadline没生效。

解决方案 #

调整后端Nginx的超时配置，把超时时间设置为不短于Cloud Tasks的dispatchDeadline（比如1800秒），这样Cloud Tasks就能按照我们设置的最长等待时间来执行任务，不会因为后端服务器提前超时而中断。

内容来源于stack exchange