Docker部署的Superset无法连接Druid集群，请求排查指导

一、先确认核心网络连通性 #

• 在EC2主机（而非Superset容器）上测试Druid节点的可访问性：
  执行curl -u admin:你的密码 http://DruidBrokerIP:8082/druid/v2/sql，如果返回{"error":"No query specified"}这类JSON错误，说明Druid Broker的SQL端点正常；如果连不上，先解决EC2到Druid集群的网络问题：
  • 检查EC2安全组是否允许出站访问Druid节点的8082/9088端口（不要只配置入站规则）
  • 检查Druid节点的安全组是否允许EC2主机的IP访问对应端口
  • 确认Druid节点的服务已正常启动，且端口绑定到0.0.0.0（而非127.0.0.1，否则仅本地可访问）
• 进入Superset容器，测试网络解析和端口连通：
  • 执行nslookup DruidBrokerHostname，确认能解析到正确IP；如果解析失败，直接用Druid节点的私有IP代替域名
  • 执行telnet DruidBrokerIP 8082，若提示Connected说明端口开放；若超时，说明容器到Druid节点的网络不通，检查：
    • Docker网络模式：如果Druid是裸机部署，可临时将Superset容器的network_mode改为host（修改docker-compose.yml后重启）测试连通性
    • Docker的iptables规则是否阻止了容器的出站请求

二、检查Druid的关键配置 #

• 确认Broker节点开启SQL支持：
  在Broker的runtime.properties中检查druid.sql.enabled=true，且druid.broker.http.port=8082绑定到0.0.0.0
• 确认基础认证配置正确：
  检查Druid集群的common.runtime.properties中：

  druid.auth.authenticatorChain=["basic"]
  druid.auth.authenticator.basic.type=basic
  druid.auth.authenticator.basic.initialAdminPassword=你的管理员密码
  druid.auth.authenticator.basic.initialInternalClientPassword=你的内部客户端密码
  

  确保Broker节点继承了这些配置，且已重启Druid服务
• 验证认证生效：在EC2主机执行curl -u wronguser:wrongpass http://DruidBrokerIP:8082/druid/v2/sql，应返回401 Unauthorized，说明认证规则正常

三、调整Superset的连接配置 #

• 修正连接字符串格式：
  正确格式为druid://admin:你的密码@DruidBrokerIP:8082/druid/v2/sql，如果密码包含特殊字符（如@、#、&），需做URL编码（比如@转成%40）
• 增加超时时间：
  在连接字符串后添加超时参数：druid://admin:密码@DruidBrokerIP:8082/druid/v2/sql?connect_timeout=60
  或者修改Superset的superset_config.py，添加全局超时配置：

  SQLALCHEMY_ENGINE_OPTIONS = {
      "connect_args": {"connect_timeout": 60}
  }
  

  之后重启Superset容器
• 检查驱动版本：
  进入Superset容器执行pip list | grep pydruid，若版本低于0.14.0，执行pip install --upgrade pydruid后重启容器

四、其他排查点 #

• 如果Druid是Docker部署，检查Druid容器的端口映射是否正确（是否将8082端口映射到EC2主机端口，或与Superset容器在同一个Docker网络）
• 检查EC2的子网路由表，若Druid集群在其他子网，确保子网间路由已开启，且安全组允许跨子网访问

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