Quarkus 和 OpenAPI / SwaggerUI：为什么 JSON 示例中的空值被抑制？

Question

我编写了一个 Quarkus REST 端点，它可能有

null

值。我正在使用带有

io.quarkus:quarkus-resteasy-reactive

、

io.quarkus:quarkus-resteasy-reactive-jackson

和

io.quarkus:quarkus-smallrye-openapi

的 Quarkus 3.5.3。

我的示例响应定义如下：

  static final String RESPONSE_ALL =
    """
      {
        "foo": "bar",
        "baz": null
      }
    """;

但是，这是我在 SwaggerUI 中看到的：

显然，任何

null

的值都会被 SwaggerUI 抑制。当示例是 REST 参数时，我看到了相同的结果。

我应该进行不同的配置吗？或者这是一个错误？

Answer 1

这是 Smallrye-open-api 版本中的一个错误/缺失功能，Quarkus 使用该库来支持 MicroProfile OpenAPI。问题已修复，您提供的

example

片段将在 OpenAPI 响应中正确呈现，从 Smallrye-open-api 版本 3.11 开始。