Docker部署的Superset 1.2.0仪表盘报504错误，修改超时配置仍无效求方案

注意：以下所有配置修改请基于你挂载到Docker容器的本地配置文件操作，避免容器重启后配置失效。

504网关超时说明请求在链路的某一层被截断，仅修改Superset本身的webserver超时不生效的情况下，可按以下顺序排查调整：

1. 调整反向代理/应用服务器超时 #

Docker部署的Superset默认会经过Nginx反向代理或者Gunicorn应用服务器，这两层默认超时一般为60s，需要单独调整：

• 若使用官方Docker Compose方案默认带Nginx，找到本地挂载的Nginx配置文件，在server配置块中添加以下参数：

  proxy_connect_timeout 300s;
  proxy_send_timeout 300s;
  proxy_read_timeout 300s;
  send_timeout 300s;
  

  修改完成后重启Nginx容器生效。
• 若未使用Nginx，直接暴露Gunicorn端口，需要调整Gunicorn启动参数，在docker-compose.yml的superset服务command配置中添加超时参数：

  command: ["gunicorn", "--timeout", "300", "-w", "10", "-b", "0.0.0.0:8088", "superset.app:create_app()"]
  

  修改完成后重启Superset Web服务容器生效。

2. 调整异步任务超时配置 #

仪表盘加载默认走Celery异步查询，你还需要在superset_config.py中补充以下超时相关配置：

# Celery任务软超时，超时后抛出异常
CELERYD_TASK_SOFT_TIME_LIMIT = 300
# Celery任务硬超时，到点直接终止任务
CELERYD_TASK_TIME_LIMIT = 360
# SQL查询超时限制
SQLLAB_TIMEOUT = 300
# 原有配置保留
SUPERSET_WEBSERVER_TIMEOUT = 300

修改完成后需要同时重启Superset Web服务和Celery Worker容器生效。

3. 优化慢查询与仪表盘配置 #

如果只有特定仪表盘触发504，大概率是该仪表盘关联的查询过慢，建议优先做性能优化，避免无限制调高超时：

• 检查该仪表盘所有图表的查询语句，给过滤、关联字段添加数据库索引，优化SQL逻辑，减少不必要的大表关联、全表扫描。
• 关闭该仪表盘不必要的自动刷新，或调大自动刷新间隔。
• 开启Superset查询缓存，配置Redis作为缓存后端，重复查询直接命中缓存无需每次访问数据库。
• 大数据量场景下建议提前做数据预聚合，通过ETL把计算结果存入中间表，再基于中间表制作图表。

4. 检查数据源侧超时配置 #

确认你对接的业务数据库的查询超时限制，比如MySQL的wait_timeout、interactive_timeout参数，如果数据库层面设置了短查询超时，需要同步调大到和Superset侧的超时配置匹配。

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