{"record":{"id":"f174ea8a3f7520c5","repo":"eclipse-vertx/vert.x","slug":"multiplexinglimit-must-be-0-or-1-disabled","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/Http2ClientConfig.java","lineNumber":79,"sourceCode":"   */\n  public int getMultiplexingLimit() {\n    return multiplexingLimit;\n  }\n\n  /**\n   * Set a client limit of the number concurrent streams for each HTTP/2 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/2 connection\n   * @return a reference to this, so the API can be used fluently\n   */\n  public Http2ClientConfig 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 default HTTP/2 connection window size\n   */\n  public int getConnectionWindowSize() {\n    return connectionWindowSize;\n  }\n\n  /**\n   * Set the default HTTP/2 connection window size. It overrides the initial window\n   * size set by {@link Http2Settings#getInitialWindowSize}, so the connection window size\n   * is greater than for its streams, in order the data throughput.\n   * <p/>\n   * A value of {@code -1} reuses the initial window size setting.","sourceCodeStart":61,"sourceCodeEnd":97,"githubUrl":"https://github.com/eclipse-vertx/vert.x/blob/fb308bd8c3f12c79f4ae89bef67fadf6c80d036e/vertx-core/src/main/java/io/vertx/core/http/Http2ClientConfig.java#L61-L97","documentation":"Configuration validation in Http2ClientConfig.setMultiplexingLimit: the limit on concurrent HTTP/2 streams per connection must be a positive number or -1 (sentinel meaning 'use the server's initial SETTINGS value'). Any other negative value is rejected as meaningless.","triggerScenarios":"Thrown at vertx-core/src/main/java/io/vertx/core/http/Http2ClientConfig.java:79 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Pass -1 to defer to the server's setting, or a value >= 1","Validate external configuration before constructing the 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-14T05:17:10.506Z"}