Quarkus与OpenAPI/SwaggerUI：JSON示例中null值为何被隐藏？

这不是bug，是默认配置导致的，只需调整两处配置即可解决：

1. 调整Jackson序列化配置，保留null字段 #

Quarkus默认的Jackson配置会忽略null值字段，导致OpenAPI无法识别这些字段。在application.properties中添加以下全局配置：

quarkus.jackson.serialization-inclusion=ALWAYS

如果只想针对特定DTO类生效，也可以在目标类上添加注解：

import com.fasterxml.jackson.annotation.JsonInclude;

@JsonInclude(JsonInclude.Include.ALWAYS)
public class YourResponseDto {
    // 字段定义
}

2. 开启SmallRye OpenAPI的null值序列化 #

让SwaggerUI在示例中显示null值，需要在application.properties中补充：

smallrye.openapi.serialize-null-values=true

完成以上配置后，重启Quarkus应用，SwaggerUI里的响应示例和参数示例就会正常显示包含null值的字段了。

内容的提问来源于stack exchange，提问作者eerriicc