Druid长运行查询触发HTTP ERROR 504网关超时异常如何处理

架构老林

2026-10-5

超时根因说明

该报错本质是大表Join查询执行时长超过了集群各组件默认的超时阈值，可从服务端、客户端两方面调整配置规避：

服务端配置调整

所有配置均在对应服务的runtime.properties配置文件中修改，调整后重启对应服务生效：

Router组件配置：如果Query节点部署了Router服务承接UI请求，需调整请求读超时和总超时，默认值通常为30~60s，可根据预估查询耗时调整，例如下方配置设置为30分钟：
```
druid.router.http.readTimeout=PT1800S
druid.router.http.requestTimeout=PT1800S
```

Broker服务配置：Query节点上的Broker负责查询全链路调度，默认查询超时为5分钟，需同步调整：

# 接口读超时
druid.broker.http.readTimeout=PT1800S
# 查询总超时
druid.broker.query.timeout=PT1800S
# SQL查询专属最大执行时长
druid.sql.planner.maxQueryExecutionTime=PT1800S

Historical服务配置：Data节点部署的Historical服务负责数据扫描，需调整内部调用超时，避免节点间交互提前中断：
```
druid.historical.http.readTimeout=PT1800S
```

客户端配置调整

Druid UI临时调整：控制台查询页面右上角设置按钮中，可手动调整查询超时参数，单位为毫秒，设置为1800000即对应30分钟，该配置为会话级，刷新页面后会失效。
Druid UI永久调整：修改UI静态资源包中的config.js文件，修改queryTimeout字段值为期望的超时时长（单位毫秒），重启UI服务后生效。
API调用场景调整：发起查询请求时，在请求头中添加X-Druid-Query-Timeout参数，值为超时毫秒数，该配置优先级高于服务端默认配置。