{"record":{"id":"d069f2c99f080670","repo":"eclipse-vertx/vert.x","slug":"multiplexinglimit-must-be-0-or-1-disabled-d069f2","errorCode":null,"errorMessage":"multiplexingLimit must be > 0 or -1 (disabled)","messagePattern":"multiplexingLimit must be > 0 or -1 \\(disabled\\)","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"vertx-core/src/main/java/io/vertx/core/http/Http3ClientConfig.java","lineNumber":64,"sourceCode":"   */\n  public int getMultiplexingLimit() {\n    return multiplexingLimit;\n  }\n\n  /**\n   * Set a client limit of the number concurrent streams for each HTTP/3 connection, this limits the number\n   * of streams the client can create for a connection. The effective number of streams for a\n   * connection is the min of this value and the server's initial settings.\n   * <p/>\n   * Setting the value to {@code -1} means to use the value sent by the server's initial settings.\n   * {@code -1} is the default value.\n   *\n   * @param limit the maximum concurrent for an HTTP/3 connection\n   * @return a reference to this, so the API can be used fluently\n   */\n  public Http3ClientConfig setMultiplexingLimit(int limit) {\n    if (limit == 0 || limit < -1) {\n      throw new IllegalArgumentException(\"multiplexingLimit must be > 0 or -1 (disabled)\");\n    }\n    this.multiplexingLimit = limit;\n    return this;\n  }\n\n  /**\n   * @return the keep alive timeout value in seconds for HTTP/3 connections\n   */\n  public Duration getKeepAliveTimeout() {\n    return keepAliveTimeout;\n  }\n\n  /**\n   * <p>Set the keep alive timeout for HTTP/3 connections. This value determines how long a connection remains\n   * unused in the pool before being evicted and closed. A timeout of zero or {@code null} means there is no timeout.</p>\n   *\n   * @param keepAliveTimeout the timeout, in seconds\n   * @return a reference to this, so the API can be used fluently","sourceCodeStart":46,"sourceCodeEnd":82,"githubUrl":"https://github.com/eclipse-vertx/vert.x/blob/fb308bd8c3f12c79f4ae89bef67fadf6c80d036e/vertx-core/src/main/java/io/vertx/core/http/Http3ClientConfig.java#L46-L82","documentation":"Configuration validation in Http3ClientConfig.setMultiplexingLimit: the limit on concurrent HTTP/3 streams per connection must be positive or -1 (sentinel meaning 'use the server's initial SETTINGS value'). Other negative values are rejected.","triggerScenarios":"Thrown at vertx-core/src/main/java/io/vertx/core/http/Http3ClientConfig.java:64 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Pass -1 or a value >= 1","Validate configuration before building the HTTP/3 client"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fb308bd8c3f12c79f4ae89bef67fadf6c80d036e","analyzedAt":"2026-09-06T11:37:12.241Z","contentChangedAt":"2026-09-06T11:37:12.241Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}