基于Nginx与Gunicorn的Python Web应用504超时问题求助

• 检查Nginx server块的超时配置
  全局http块的超时设置可能被具体站点的server配置覆盖。找到你的站点配置文件（通常在/etc/nginx/sites-available/目录下），检查里面是否有proxy_read_timeout、proxy_connect_timeout这类参数，如果设置了60s，改成900s。修改后重启Nginx：sudo systemctl restart nginx。

• 确认Gunicorn超时配置真正生效
  先查看Gunicorn进程的启动参数，执行ps aux | grep gunicorn，看输出里是否包含--timeout 900。如果是用systemd管理Gunicorn，打开服务文件（比如/etc/systemd/system/gunicorn.service），检查ExecStart行是否有该参数，没有的话加上，然后执行sudo systemctl daemon-reload && sudo systemctl restart gunicorn。

• 排查中间层超时限制

  • 如果你用了Digital Ocean负载均衡器，它默认超时是60秒，需要到DO控制台的负载均衡器设置里，把超时时间调整为900秒。
  • 如果用了CDN服务，检查CDN的超时设置，确保没有限制在60秒内。

• 检查Python应用内部的超时设置
  部分Web框架或业务代码可能有自己的超时逻辑，比如Django的SERVER_TIMEOUT，或者自定义的请求超时处理。排查应用代码，确认没有硬编码的60秒超时限制。

• 验证超时配置并定位问题源
  写一个测试接口模拟长请求，比如：

  # Flask示例
  @app.route('/test-long-request')
  def test_long_request():
      import time
      time.sleep(70)  # 超过60秒
      return "请求成功完成"
  

  用curl http://your-domain/test-long-request发起请求，同时查看Nginx错误日志（/var/log/nginx/error.log）和Gunicorn日志，根据日志信息判断超时是来自Nginx、Gunicorn还是其他中间层。

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