如何配置Vertx 3.7.0网关超时时间 解决504网关超时错误

Vert.x 3.7.0 网关超时配置方案 #

你遇到的504超时是因为Vert.x做网关转发时，默认使用的WebClient/HttpClient请求超时为30秒，和你查到的核心库默认超时规则一致，两种配置方式如下：

1. JSON配置文件可直接使用的参数 #

如果你的网关是基于Vert.x Web Proxy或者官方脚手架生成的服务，可直接在JSON配置中添加httpClient相关的超时配置项，示例如下：

{
  "gateway": {
    "port": 8080,
    "httpClient": {
      "connectTimeout": 125000,
      "idleTimeout": 125000,
      "timeout": 125000
    }
  }
}

三个参数单位都是毫秒，上面的配置对应超时时间设为125秒，略长于你的业务最长处理时间2分钟，避免边界请求超时：

• timeout：整体请求响应的最大耗时，是直接控制转发超时的核心参数
• connectTimeout：和上游服务建立TCP连接的超时时间
• idleTimeout：连接空闲无数据传输的超时时间

2. 代码中显式配置对应参数 #

如果你是自行封装HttpClient做转发逻辑，在初始化HttpClient时传入配置即可，示例代码：

HttpClientOptions options = new HttpClientOptions()
  .setTimeout(125000)
  .setConnectTimeout(125000)
  .setIdleTimeout(125000);
HttpClient httpClient = vertx.createHttpClient(options);

如果使用的是WebClient，配置逻辑完全一致，传入同一个HttpClientOptions对象即可。

注意事项 #

• 3.7.0版本不存在部分高版本才有的网关独立超时参数，所有转发超时控制都通过底层HttpClient的配置生效
• 如果你同时配置了服务端的请求超时，需要确保服务端超时时间大于上游业务的处理时间，避免网关层面先返回超时

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