Apache Superset连接PostgreSQL遇网关超时问题求助

针对你在Kubernetes部署的Apache Superset遇到的30秒网关超时问题，以下是可尝试的排查和修复步骤：

1. 检查Kubernetes Ingress超时配置 #

大部分Ingress控制器（如NGINX Ingress）默认超时为30秒，这是最可能的根源。需要在Ingress资源中添加超时注解，覆盖默认值：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/proxy-read-timeout: "600"
    nginx.ingress.kubernetes.io/proxy-send-timeout: "600"
    nginx.ingress.kubernetes.io/proxy-connect-timeout: "60"
    # 旧版本NGINX Ingress可能使用以下键名
    # nginx.org/proxy-read-timeout: "600"
    # nginx.org/proxy-send-timeout: "600"
  name: superset-ingress
  # ...其他元数据
spec:
  # ...Ingress规则

配置完成后应用Ingress资源或重启Ingress控制器。

2. 验证Gunicorn启动参数有效性 #

确保Gunicorn的超时参数实际生效：

• 检查K8s Deployment的启动命令，确认是否显式传递了--timeout参数：

  command: ["gunicorn"]
  args: [
    "--timeout", "600",
    "--workers", "4",
    "--bind", "0.0.0.0:8088",
    "superset.app:create_app()"
  ]
  

• 若使用Superset内置启动脚本，在Pod中执行echo $GUNICORN_TIMEOUT验证环境变量是否正确注入，确保superset_config.py中的GUNICORN_TIMEOUT=600被加载。

3. 检查PostgreSQL端超时限制 #

数据库端的statement_timeout可能强制限制查询时长：

• 在SQL Lab中执行查询：show statement_timeout;，若返回值为30000（30秒），可通过两种方式调整：
  • 修改PostgreSQL服务器的postgresql.conf，设置statement_timeout = 600000（10分钟）后重启服务。
  • 在Superset的PostgreSQL连接配置中添加参数：options='-c statement_timeout=600000'，覆盖数据库默认设置。

4. 配置Celery异步任务超时（若使用） #

如果Superset启用Celery处理异步查询（如仪表盘异步加载），需调整Celery相关参数：
在superset_config.py中添加：

CELERY_BROKER_URL = "redis://your-redis-host:6379/0"
CELERY_RESULT_BACKEND = "redis://your-redis-host:6379/0"
CELERYD_TASK_SOFT_TIME_LIMIT = 600
CELERYD_TASK_TIME_LIMIT = 660  # 比软超时稍长，强制终止超时任务

同时确保Celery Worker的启动参数未覆盖这些配置。

5. 排查集群内中间代理超时 #

若集群使用Service Mesh（如Istio）或其他反向代理：

• 对于Istio，检查VirtualService中的timeout配置：

  apiVersion: networking.istio.io/v1alpha3
  kind: VirtualService
  metadata:
    name: superset-vs
  spec:
    hosts:
    - superset.example.com
    http:
    - route:
      - destination:
          host: superset-service
        timeout: 10m  # 设置为10分钟
  

• 其他代理（如Envoy）需对应调整超时配置。

6. 验证Pod探针配置 #

确保K8s Pod的存活/就绪探针不会干扰正常请求：

livenessProbe:
  httpGet:
    path: /health
    port: 8088
  initialDelaySeconds: 60
  periodSeconds: 30
  timeoutSeconds: 10  # 探针超时不要过短
readinessProbe:
  httpGet:
    path: /health
    port: 8088
  initialDelaySeconds: 30
  periodSeconds: 10
  timeoutSeconds: 5

避免探针超时导致Pod被误重启，中断长查询。

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