Kubernetes环境下Nginx-Ingress导致文本流功能失效的问题求助

问题背景 #

在Azure Kubernetes集群中通过Helm部署Nginx-Ingress后，前端容器的流式文本响应在通过Ingress访问时无法实时输出，需等待完整内容生成后才能获取，但本地测试和手机端访问正常。排查发现问题与Nginx的代理缓冲配置相关，但之前的Ingress注解配置未解决问题。

解决方案 #

一、修正Ingress资源注解 #

你之前的Ingress配置存在两处关键问题：

• proxy_request_buffering的值写错为"of"，应为"off"
• nginx.ingress.kubernetes.io/proxy_pass注解无需手动设置，Ingress会根据spec中的后端服务自动生成proxy_pass规则

正确的Ingress配置示例：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nnais-streamlit-ingress
  annotations:
    nginx.ingress.kubernetes.io/proxy-buffering: "off"
    nginx.ingress.kubernetes.io/proxy-http-version: "1.1"
    nginx.ingress.kubernetes.io/chunked-transfer-encoding: "on"
    nginx.ingress.kubernetes.io/proxy_request_buffering: "off"
    # 新增：确保HTTP/1.1长连接正常，避免流式响应被中断
    nginx.ingress.kubernetes.io/proxy-set-header: "Connection \"\""
spec:
  ingressClassName: nginx # 需匹配你的Nginx-Ingress控制器类名
  rules:
  - host: your-domain.com # 替换为你的域名，留空可直接用LB IP访问
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: your-frontend-service # 替换为前端服务名称
            port:
              number: 3000 # 替换为前端服务监听端口

应用配置：

kubectl apply -f your-ingress.yaml

二、通过Helm安装时全局配置（可选） #

如果需要让集群内所有Ingress默认启用流式响应支持，可以在Helm安装/升级Nginx-Ingress时添加全局配置参数：

helm upgrade --install ingress-nginx ingress-nginx \
  --repo https://kubernetes.github.io/ingress-nginx \
  --namespace ingress-nginx \
  --create-namespace \
  --set controller.service.loadBalancerIP=<ip-adress> \
  --set controller.service.annotations."service\.beta\.kubernetes\.io/azure-load-balancer-health-probe-request-path"=/healthz \
  # 全局禁用代理缓冲相关配置
  --set controller.config.proxy-buffering="off" \
  --set controller.config.proxy-request-buffering="off" \
  --set controller.config.proxy-http-version="1.1" \
  --set controller.config.chunked-transfer-encoding="on" \
  # 全局设置Connection头，适配HTTP/1.1长连接
  --set controller.config.proxy-set-header='Connection ""'

三、额外验证步骤 #

• 检查后端服务的响应头是否包含Transfer-Encoding: chunked，确保后端正确输出流式响应
• 通过浏览器开发者工具的Network标签，确认客户端未开启强制缓存，且响应是分块加载状态
• 若使用HTTPS，无需额外特殊配置，Nginx-Ingress默认支持TLS下的流式传输

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