如何在DBeaver/DbVisualizer中延长ClickHouse JDBC HTTP连接超时

核心原因是你混淆了ClickHouse JDBC TCP驱动和HTTP驱动的超时参数：socket_timeout是TCP驱动专属参数，HTTP驱动不支持该参数，所以会报错或不生效。针对HTTP驱动，需要使用对应的HTTP相关超时参数。

DBeaver 设置步骤 #

• 打开目标ClickHouse连接的「编辑连接」窗口，切换到「驱动属性」标签页
• 在属性列表中找到 http_socket_timeout 参数（若未显示，可点击「添加属性」手动创建），设置值为所需毫秒数（例如 300000 对应5分钟）
• 也可以直接在JDBC URL中追加参数，格式如下：

  jdbc:clickhouse://<你的ClickHouse地址>:8123/<数据库名>?http_socket_timeout=300000
  

  注意：HTTP驱动默认端口为8123，确保URL使用HTTP驱动的格式，不要与TCP驱动（默认9000端口）混淆

DbVisualizer 设置步骤 #

• 打开连接属性窗口，进入「Driver Properties」面板
• 找到 http_socket_timeout 参数，设置对应的毫秒超时值
• 或直接在「Connection URL」末尾追加参数：

  ?http_socket_timeout=300000
  

额外说明 #

• 若需要控制连接建立阶段的超时，可同时设置 http_connection_timeout 参数（同样为毫秒值）
• 若查询执行本身耗时较长，还可添加 query_timeout 参数控制查询的最大执行时间
• 确保你的ClickHouse JDBC驱动为最新稳定版，旧版本可能缺少部分参数支持

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