{"record":{"id":"bf888d4ff640abbd","repo":"eclipse-vertx/vert.x","slug":"http-3-keepalivetimeout-must-be-0","errorCode":null,"errorMessage":"HTTP/3 keepAliveTimeout must be >= 0","messagePattern":"HTTP/3 keepAliveTimeout must be >= 0","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"vertx-core/src/main/java/io/vertx/core/http/Http3ClientConfig.java","lineNumber":86,"sourceCode":"  }\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\n   */\n  public Http3ClientConfig setKeepAliveTimeout(Duration keepAliveTimeout) {\n    if (keepAliveTimeout != null && (keepAliveTimeout.isNegative())) {\n      throw new IllegalArgumentException(\"HTTP/3 keepAliveTimeout must be >= 0\");\n    }\n    this.keepAliveTimeout = keepAliveTimeout;\n    return this;\n  }\n\n  /**\n   * @return the initial HTTP/3 connection settings sent by the client\n   */\n  public Http3Settings getInitialSettings() {\n    return initialSettings;\n  }\n\n  /**\n   * Set the HTTP/3 connection settings sent by the client.\n   *\n   * @param settings the settings value\n   * @return a reference to this, so the API can be used fluently\n   */","sourceCodeStart":68,"sourceCodeEnd":104,"githubUrl":"https://github.com/eclipse-vertx/vert.x/blob/fb308bd8c3f12c79f4ae89bef67fadf6c80d036e/vertx-core/src/main/java/io/vertx/core/http/Http3ClientConfig.java#L68-L104","documentation":"Configuration validation in Http3ClientConfig.setKeepAliveTimeout: the Duration controlling idle HTTP/3 connection eviction from the pool must be non-negative (zero or null disables the timeout). Negative durations are rejected by the setter.","triggerScenarios":"Thrown at vertx-core/src/main/java/io/vertx/core/http/Http3ClientConfig.java:86 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a zero or positive Duration (or null)","Validate Duration values from external configuration"],"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"}