eclipse-vertx/vert.x · error · IllegalArgumentException

Missing QLog description configuration

Error message

Missing QLog description configuration

What it means

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

Source

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

//              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;

    public QuicDispatcher(ServerID serverID, SslContextProviderReference sslContextProviderRef) {
      this.serverID = serverID;
      this.sslContextProviderRef = sslContextProviderRef;

View on GitHub (pinned to fb308bd8c3)

Solutions

1. Set a non-null description on QLogConfig
2. Or remove the QLogConfig to disable qlogging

When it happens

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