Java JDBC连接ClickHouse超时求助（调max_execution_time无效）

问题复盘 #

Java通过JDBC连接ClickHouse执行查询时，超过3秒就触发服务端超时错误：

Code: 159. DB::Exception: Timeout exceeded: elapsed 5.060592159 seconds, maximum: 3. (TIMEOUT_EXCEEDED) (version 22.10.2.11 (official build))

但IntelliJ IDEA等工具连接无此问题，已修改服务端max_execution_time = 800，且JDBC URL添加了socket_timeout，问题仍存在。

核心原因 #

报错是服务端执行超时，而非客户端socket超时。你遇到的情况大概率是：

• 服务端的max_execution_time配置未真正生效（比如改了错误的配置文件或未重启服务）
• JDBC驱动在连接时默认传递了max_execution_time=3的参数，覆盖了服务端全局配置

解决步骤 #

1. 验证服务端配置是否生效 #

首先确认服务端的max_execution_time是否真的设置成功：

• 修改对应用户的配置文件（如user.xml），在目标用户（比如default）的配置块中添加：

  <users>
    <default>
      ...
      <max_execution_time>800</max_execution_time> <!-- 单位：秒 -->
      ...
    </default>
  </users>
  

• 重启ClickHouse服务
• 在ClickHouse客户端执行以下SQL，查看当前生效值：

  SELECT getSetting('max_execution_time');
  

  若返回结果不是800，说明配置未生效，检查文件路径、权限或重启是否成功。

2. 在JDBC URL中强制指定服务端超时参数 #

JDBC驱动可能会默认设置max_execution_time=3，覆盖服务端配置。直接在URL中显式指定该参数：

String url = "jdbc:clickhouse://your-host:8123/your-db?user=default&password=your-pass&max_execution_time=800";

注意：参数值单位为秒，和服务端配置一致。

3. 会话级别临时设置超时 #

如果不想修改全局配置或URL参数，可以在执行目标查询前，先执行会话级设置：

try (Connection conn = DriverManager.getConnection(url)) {
    try (Statement stmt = conn.createStatement()) {
        // 设置当前会话的执行超时为800秒
        stmt.execute("SET max_execution_time=800");
        // 执行你的慢查询
        ResultSet rs = stmt.executeQuery("SELECT * FROM your_large_table");
        // 处理结果...
    }
}

4. 升级JDBC驱动版本 #

部分旧版本的ClickHouse JDBC驱动存在参数传递bug，和22.10版本的服务端不兼容。尝试升级到最新稳定版（比如0.4.2及以上），maven依赖示例：

<dependency>
    <groupId>com.clickhouse</groupId>
    <artifactId>clickhouse-jdbc</artifactId>
    <version>0.4.2</version>
</dependency>

关键区分 #

• socket_timeout：客户端等待服务端响应的超时时间，和服务端执行超时无关，设置再大也解决不了Code159错误
• max_execution_time：服务端允许查询执行的最长时间，这才是解决该报错的关键参数

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