eclipse-vertx/vert.x · error · IllegalArgumentException

Missing QLog title configuration

Error message

Missing QLog title configuration

What it means

Incomplete QLog configuration in QuicServerImpl.createCodecBuilder: a QLogConfig was supplied but its title field is null, leaving the qlog metadata incomplete. The input at fault is QLogConfig.title on the server's QuicConfig.

Source

Thrown at vertx-core/src/main/java/io/vertx/core/net/impl/quic/QuicServerImpl.java:260

          // OK
          ((QuicChannel) ctx.channel()).collectStats().addListener(f -> {
//            if (f.isSuccess()) {
//              System.out.println("Connection closed: " + f.getNow());
//            }
            //only test for first connection
//            ctx.channel().parent().close();
          });
        }
*/
      });

    QLogConfig qlogCfg = config.getQLogConfig();
    if (qlogCfg != null) {
      if (qlogCfg.getPath() == null) {
        throw new IllegalArgumentException("Missing QLog path configuration");
      }
      if (qlogCfg.getTitle() == null) {
        throw new IllegalArgumentException("Missing QLog title configuration");
      }
      if (qlogCfg.getDescription() == null) {
        throw new IllegalArgumentException("Missing QLog description configuration");
      }
      QLogConfiguration qLogConfiguration = new QLogConfiguration(qlogCfg.getPath(),
        qlogCfg.getTitle(),
        qlogCfg.getDescription());
      builder.option(QuicChannelOption.QLOG, qLogConfiguration);
    }
    return builder;
  }

  private class QuicDispatcher extends QuicCodecDispatcher implements Shareable {

    private final ServerID serverID;
    private final SslContextProviderReference sslContextProviderRef;
    private Map<Channel, ServerRegistration> registrations;

View on GitHub (pinned to fb308bd8c3)

Solutions

1. Set a non-null title on QLogConfig
2. Or drop the QLogConfig entirely to disable qlogging

When it happens

Trigger: Thrown at vertx-core/src/main/java/io/vertx/core/net/impl/quic/QuicServerImpl.java:260 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/260aa46ddb7dea3f. Report an issue: GitHub.