GCP Cloud Run部署Laravel大体积POST请求报错超时问题

问题现象 #

• 发起携带64MB、100余行数据的POST请求执行数据库保存时，页面返回Nginx默认错误页：
  
• Cloud Run日志明确报错：The request has been terminated because it has reached the maximum request timeout.
• 常规小体积请求运行完全正常，当前部署架构为Docker+Nginx+PHP-FPM，Laravel版本为v9。

问题根因 #

报错本质是多层超时配置不匹配，大体积请求解析+数据落库的总处理时长超过了当前配置的最短超时阈值，Nginx在连接被上游强制断开后返回默认错误页。当前已配置的client_max_body_size 100m已满足64MB请求体的上传大小要求，不存在请求体积超限问题。

修复步骤 #

1. 调整Cloud Run服务层超时上限 #

Cloud Run默认请求超时为300秒，若请求处理总时长超过该值，会被Cloud Run基础设施直接强制终止，这是日志中超时报错的最核心诱因。

• 命令行部署时追加参数指定超时（示例设置为600秒，可根据实际业务耗时调整，最大支持3600秒）：
  gcloud run deploy [你的服务名] --timeout=600
• 也可在GCP控制台Cloud Run服务的「修订版本-容器配置」页直接修改请求超时时长，保存后重新发布修订版本即可。
  注意：Cloud Run层的超时值是全链路的上限，后续Nginx、PHP配置的超时值必须小于等于该值，否则仍会被Cloud Run优先终止连接

2. 补全Nginx缺失的超时配置 #

当前nginx.conf未配置Nginx与PHP-FPM通信的相关超时参数，默认值仅为几十秒，长请求极易触发Nginx主动断开连接。在location ~ \.php$配置块内补充以下参数：

# FastCGI连接、发送、读取超时
fastcgi_connect_timeout 600s;
fastcgi_send_timeout 600s;
fastcgi_read_timeout 600s;
# 大请求体读取超时
client_body_timeout 600s;
# 响应发送超时
send_timeout 600s;

3. 调整PHP运行时配置 #

当前使用的php:8.0-fpm-alpine镜像默认PHP最大执行时间仅30秒，无法满足长请求处理要求，在Dockerfile中添加以下构建步骤，写入自定义PHP配置覆盖默认值：

# 写入超时、上传大小、内存限制配置
RUN echo "max_execution_time = 600" > /usr/local/etc/php/conf.d/custom.ini && \
    echo "max_input_time = 600" >> /usr/local/etc/php/conf.d/custom.ini && \
    echo "post_max_size = 100M" >> /usr/local/etc/php/conf.d/custom.ini && \
    echo "memory_limit = 256M" >> /usr/local/etc/php/conf.d/custom.ini

其中post_max_size与Nginx的client_max_body_size保持一致，memory_limit可根据实际数据处理的内存占用调整，避免内存不足导致进程退出。

4. 业务逻辑优化（建议项） #

正常情况下100余行数据的落库操作耗时应在秒级，如果调整完所有超时配置仍触发超时，需要排查业务逻辑问题：

• 避免在循环中单条执行数据库插入/更新操作，改用Laravel提供的Model::insert($data)批量写入方法，大幅减少数据库IO次数
• 提前优化数据格式化、关联查询逻辑，移除不必要的计算、请求操作
• 若业务逻辑确实需要长时间处理，不要用同步接口等待结果，改用Laravel队列做异步处理：接口收到请求后将任务投递到队列直接返回受理结果，后台队列任务异步执行落库，从根源上规避请求超时问题。

验证方式 #

所有配置调整完成后，重新构建Docker镜像部署到Cloud Run，发起相同请求测试，只要总处理时长在设置的超时阈值内，即可正常返回结果，不会再出现Nginx错误页和超时报错。

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