eclipse-vertx/vert.x · error · IllegalArgumentException

clusterPingReplyInterval must be greater than 0

Error message

clusterPingReplyInterval must be greater than 0

What it means

Configuration validation in setClusterPingReplyInterval: the time in milliseconds to wait for a pong before considering a cluster node dead must be positive. A non-positive reply window would immediately mark healthy nodes as dead, so the setter rejects it.

Source

Thrown at vertx-core/src/main/java/io/vertx/core/eventbus/EventBusOptions.java:573

  /**
   * Get the value of cluster ping reply interval, in ms.
   * After sending a ping, if a pong is not received in this time, the node will be considered dead.
   *
   * @return the value of cluster ping reply interval
   */
  public long getClusterPingReplyInterval() {
    return clusterPingReplyInterval;
  }

  /**
   * Set the value of cluster ping reply interval, in ms.
   *
   * @param clusterPingReplyInterval The value of cluster ping reply interval, in ms.
   * @return a reference to this, so the API can be used fluently
   */
  public EventBusOptions setClusterPingReplyInterval(long clusterPingReplyInterval) {
    if (clusterPingReplyInterval < 1) {
      throw new IllegalArgumentException("clusterPingReplyInterval must be greater than 0");
    }
    this.clusterPingReplyInterval = clusterPingReplyInterval;
    return this;
  }

  /**
   * Get the public facing host to be used when clustering.
   *
   * @return the public facing port
   */
  public String getClusterPublicHost() {
    return clusterPublicHost;
  }

  /**
   * Set the public facing hostname to be used for clustering.
   * Sometimes, e.g. when running on certain clouds, the local address the server listens on for clustering is
   * not the same address that other nodes connect to it at, as the OS / cloud infrastructure does some kind of

View on GitHub (pinned to fb308bd8c3)

Solutions

1. Use a positive reply interval in ms (default 20000)
2. Validate values deserialized from JSON configuration

When it happens

Trigger: Thrown at vertx-core/src/main/java/io/vertx/core/eventbus/EventBusOptions.java:573 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of eclipse-vertx/vert.x@fb308bd8c3 (2026-09-06). Data as JSON: /api/errors/fe818d2df3da88a0. Report an issue: GitHub.