eclipse-vertx/vert.x · error · IllegalArgumentException

Invalid ${value}

Error message

Invalid ${value}

What it means

Static configuration validation in IoUringTransport.setPendingFastOpenRequestsThreshold: the io_uring TCP_FASTOPEN pending-connections threshold must be valid (positive). Generic 'Invalid <value>' sentinel; the input at fault is the int passed to the global setter.

Source

Thrown at vertx-core/src/main/java/io/vertx/core/impl/transports/IoUringTransport.java:56

  private static volatile int pendingFastOpenRequestsThreshold = 256;

  /**
   * Return the number of pending TFO connections in SYN-RCVD state for TCP_FASTOPEN.
   * <p>
   * {@see #setPendingFastOpenRequestsThreshold}
   */
  public static int getPendingFastOpenRequestsThreshold() {
    return pendingFastOpenRequestsThreshold;
  }

  /**
   * Set the number of pending TFO connections in SYN-RCVD state for TCP_FASTOPEN
   * <p/>
   * If this value goes over a certain limit the server disables all TFO connections.
   */
  public static void setPendingFastOpenRequestsThreshold(int value) {
    if (value < 0) {
      throw new IllegalArgumentException("Invalid " + value);
    }
    pendingFastOpenRequestsThreshold = value;
  }

  public IoUringTransport() {
  }

  @Override
  public boolean supportsDomainSockets() {
    return true;
  }

  @Override
  public SocketAddress convert(io.vertx.core.net.SocketAddress address) {
    if (address.isDomainSocket()) {
      return new DomainSocketAddress(address.path());
    }
    return Transport.super.convert(address);

View on GitHub (pinned to fb308bd8c3)

Solutions

1. Pass a positive threshold value (default 256)
2. Validate configuration values before setting the global

When it happens

Trigger: Thrown at vertx-core/src/main/java/io/vertx/core/impl/transports/IoUringTransport.java:56 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/da8b66454f1678c2. Report an issue: GitHub.