Kubernetes中EventSource-SSEEmitter连接Nginx超时问题求助

问题背景 #

Spring Boot后端部署在Kubernetes DaemonSet的Pod中，同Pod内的Nginx提供Angular(Ionic)前端服务，集群使用Nginx Ingress Controller做负载均衡。常规前后端通信正常，但SSE/EventSource连接在约50秒无消息时触发504 Gateway Time-Out，后续服务器推送无法被接收。已尝试调整Ingress及Pod内Nginx的proxy_read_timeout参数，效果不稳定；本地Minikube环境偶尔生效，生产集群完全无效，希望避免后端发送心跳包维持连接。

核心原因分析 #

1. Ingress Controller的超时配置未精准应用到SSE请求路径
2. 生产集群前置负载均衡（如云厂商LB）存在默认空闲超时拦截
3. Ingress Controller注解配置错误或版本兼容性问题
4. Spring Boot后端SSE响应头配置不完整

分步解决方案 #

1. 精准配置Ingress的SSE专属参数 #

针对后端SSE路径（/spring）单独设置超时及连接参数，修改Ingress的metadata.annotations：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    kubernetes.io/ingress.class: nginx
    kubernetes.io/rewrite-target: /
    nginx.ingress.kubernetes.io/cors-allow-headers: Content-Type
    nginx.ingress.kubernetes.io/cors-allow-methods: POST, GET, OPTIONS
    nginx.ingress.kubernetes.io/cors-allow-origin: "*"
    # 针对SSE的长连接超时配置
    nginx.ingress.kubernetes.io/proxy-read-timeout: "3600"
    nginx.ingress.kubernetes.io/proxy-send-timeout: "3600"
    nginx.ingress.kubernetes.io/proxy-connect-timeout: "30"
    # 启用HTTP/1.1及长连接保持
    nginx.ingress.kubernetes.io/proxy-http-version: "1.1"
    nginx.ingress.kubernetes.io/proxy-set-header: "Connection \"keep-alive\""
    # 启用EventSource专属优化
    nginx.ingress.kubernetes.io/eventsource: "true"
    # 可选：通过server-snippet强制路径级配置（避免全局覆盖失效）
    nginx.ingress.kubernetes.io/server-snippet: |
      location /spring {
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
        proxy_http_version 1.1;
        proxy_set_header Connection "keep-alive";
        proxy_set_header Host $host;
      }
  name: ingress
  namespace: test-afm
spec:
  # 原有spec配置保持不变
  tls:
    - hosts:
        - iot-dev.local
      secretName: some-cert
  rules:
    - host: iot-dev.local
      http:
        paths:
          - backend:
              service:
                name: service-dev
                port:
                  number: 80
            path: /
            pathType: Prefix
          - backend:
              service:
                name: service-dev
                port:
                  number: 8080
            path: /spring
            pathType: Prefix

2. 排查生产集群前置负载均衡超时 #

若生产集群Ingress Controller前有云厂商负载均衡（如AWS ALB、GCP LB），需检查其空闲超时设置：

• 云厂商LB默认空闲超时多为60秒，需调整至与Ingress配置匹配的时长（如3600秒）
• 确保LB未对HTTP长连接做强制断开处理

3. 验证Ingress Controller配置生效 #

进入Ingress Controller Pod，检查生成的Nginx配置是否包含预期的超时参数：

# 替换为实际的Ingress Controller Pod名称及命名空间
kubectl exec -it nginx-ingress-controller-xxxx -n kube-system -- grep -A 15 "location /spring" /etc/nginx/nginx.conf

确认输出中存在proxy_read_timeout 3600s;等配置，说明Ingress注解已生效。

4. 完善Spring Boot SSE响应配置 #

在后端SSE接口中添加完整的响应头，确保与Nginx的长连接配置匹配：

@GetMapping("/your-sse-endpoint")
public SseEmitter sseEndpoint(HttpServletResponse response) {
    // 设置SSE响应头
    response.setHeader("Connection", "keep-alive");
    response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
    response.setContentType("text/event-stream");
    response.setCharacterEncoding("UTF-8");
    
    // 设置Emitter超时时间（单位：毫秒，此处为1小时）
    SseEmitter emitter = new SseEmitter(3600000L);
    // 后续业务逻辑
    return emitter;
}

验证方法 #

1. 使用curl模拟SSE长连接：

curl -N https://iot-dev.local/spring/your-sse-endpoint

等待超过50秒，若连接未断开且后续能接收服务器推送，说明配置生效。
2. 查看Ingress Controller日志，确认无超时相关错误：

kubectl logs nginx-ingress-controller-xxxx -n kube-system

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