Kubernetes环境下NGINX Ingress长请求超时问题求助

我们在Kubernetes环境中部署了React前端与FastAPI后端，当前遇到长耗时API请求的问题：某一API调用需约2分钟完成，但前端会在此期间超时并断开与后端的连接，进而自动触发第二次请求（此时第一次请求仍在运行）。

根据后端Pod的部署方式，这会引发不同问题：

• 单后端Pod：前端在同一Pod上重试请求，导致请求重叠，增加单实例负载；
• 多后端Pod：前端在空闲Pod上重试，会在新实例上从头启动流程，造成负载重复。

为解决超时问题，我们尝试调整了以下NGINX代理超时参数：

proxy-read-timeout: 300s
proxy-send-timeout: 300s
client-body-timeout: 300s

但请求仍被限制在50秒超时，该限制似乎来自NGINX配置（Lua段的nginx.conf）中的全局设置。即使通过Helm升级自定义Chart应用这些更新后的超时参数，50秒限制依然存在。

我们寻求两方面的建议：

1. 如何有效覆盖或增加NGINX Ingress Controller中的全局超时，以支持超过50秒的请求；
2. 针对该场景解决超时问题或管理长超时的相关指导。

（我们正为应用其他部分调研Redis队列方案，但针对此API端点似乎过于冗余）

1. 覆盖NGINX Ingress Controller全局超时 #

方式一：Ingress资源注解配置（推荐） #

直接在目标API对应的Ingress资源中添加注解，优先级高于全局配置，精准覆盖超时限制：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: your-app-ingress
  annotations:
    nginx.ingress.kubernetes.io/proxy-read-timeout: "300"
    nginx.ingress.kubernetes.io/proxy-send-timeout: "300"
    nginx.ingress.kubernetes.io/client-body-timeout: "300"
    # HTTP 1.1场景需补充连接超时配置
    nginx.ingress.kubernetes.io/proxy-connect-timeout: "300"
spec:
  # 你的Ingress规则配置

方式二：Helm全局配置修改 #

如果需要全局生效所有请求，修改Helm values.yaml中的控制器配置，覆盖默认50秒限制：

controller:
  config:
    proxy-read-timeout: "300"
    proxy-send-timeout: "300"
    client-body-timeout: "300"
    proxy-connect-timeout: "300"

执行Helm升级后，重启Ingress Controller Pod使配置生效：

kubectl rollout restart deployment/nginx-ingress-controller -n <ingress-namespace>

Lua段限制排查 #

若上述配置仍不生效，需检查NGINX的Lua逻辑是否存在自定义拦截：

• 进入NGINX Pod查看生成的配置：kubectl exec -it <nginx-pod-name> -n <namespace> -- cat /etc/nginx/nginx.conf
• 查找set_by_lua或lua_*相关的超时设置，若存在，需通过Ingress Controller的ConfigMap或Helm values添加对应Lua参数，或修改自定义Chart中的Lua逻辑。

2. 长耗时请求的优化方案 #

前端侧调整 #

• 禁用自动重试：修改React请求工具（如Axios、Fetch）的配置，关闭该API的自动重试机制，避免重复发起请求。
• 延长前端超时：将该API的请求超时设置调整为300秒以上，确保能等待后端响应完成。
• 轮询替代长连接：若前端无法长时间保持连接，改为“提交任务+轮询状态”模式：先调用接口提交任务获取ID，再定期轮询任务进度/结果。

后端侧优化 #

• 异步拆分接口：把长耗时API拆分为两个接口：一个用于提交任务（立即返回任务ID），另一个用于查询任务状态。后端用BackgroundTasks（FastAPI内置）处理异步逻辑，避免阻塞请求连接。
• 调整FastAPI自身超时：确保Uvicorn的连接保持超时足够长：

# main.py
import uvicorn
from fastapi import FastAPI

app = FastAPI()

# 你的路由逻辑

if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000, timeout_keep_alive=300)

方案选型建议 #

仅针对单个API的长耗时需求，Redis队列方案确实冗余，优先通过超时配置调整+前端逻辑优化解决；若后续出现大量同类长耗时任务，再考虑引入队列系统。

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