eclipse-vertx/vert.x · error · IllegalArgumentException

clusterPingInterval must be greater than 0

Error message

clusterPingInterval must be greater than 0

What it means

Configuration validation in setClusterPingInterval: the interval in milliseconds between cluster liveness pings must be positive. A zero or negative interval would spam the cluster with pings continuously, so the setter rejects it.

Source

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

  /**
   * 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 getClusterPingInterval() {
    return clusterPingInterval;
  }

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

  /**
   * 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.
   *

View on GitHub (pinned to fb308bd8c3)

Solutions

1. Use a positive interval in ms (default 20000)
2. Sanitize cluster configuration from JSON before constructing EventBusOptions

When it happens

Trigger: Thrown at vertx-core/src/main/java/io/vertx/core/eventbus/EventBusOptions.java:549 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/98744f3646e04a4b. Report an issue: GitHub.