如何在Apollo Angular、GraphQL、NestJS应用中延长响应超时解决504错误

核心问题拆解 #

1. 504 Gateway Timeout原因：Nginx默认的后端响应超时时间（通常为60秒）短于你的API处理耗时（2分钟），导致Nginx提前断开连接返回504，但后端进程未被中断，仍能完成数据写入操作。
2. Nginx配置报错原因：你将http级别的指令放到了错误的配置层级（比如server或location块内部）。Nginx配置是层级化结构，http作为顶级块，不能嵌套在其他块中。

正确的Nginx超时配置方式 #

方式1：全局范围调整（所有站点生效） #

在Nginx主配置文件的http块中添加/修改超时参数：

http {
    # 客户端请求头/体的超时时间
    client_header_timeout 3m;
    client_body_timeout 3m;

    # Nginx与后端服务器的连接、发送、读取超时
    proxy_connect_timeout 3m;
    proxy_send_timeout 3m;
    proxy_read_timeout 3m;
}

方式2：单个站点/路由调整（仅目标API生效） #

如果无需全局修改，可在对应站点的server块或特定location块中添加后端代理超时参数（注意不要嵌套http块）：

server {
    listen 80;
    server_name your-domain.com;

    location /api/large-upload {
        proxy_pass http://your-backend:port;
        # 仅针对该上传接口延长超时
        proxy_connect_timeout 3m;
        proxy_send_timeout 3m;
        proxy_read_timeout 3m;
    }
}

额外优化建议 #

• 异步处理+轮询：后端放弃同步处理大上传请求，改为接收请求后返回任务ID，后台异步执行处理逻辑，前端通过轮询任务ID获取进度和最终结果，从根源避免超时问题。
• 前端超时同步调整：如果前端使用axios、fetch等工具，需对应延长请求超时时间，比如axios设置timeout: 180000（3分钟），避免前端先于Nginx中断请求。
• 文件分片上传：将大文件切割为多个小分片（比如10MB/片），逐个上传后由后端合并，降低单次请求的处理压力和超时风险。

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