springdoc-openapi-ui - Springdoc openapi 3 @Schema 示例被忽略

Question

@Schema Example 在一个类属性上被 springdoc Openapi 忽略，但在同一类中的其他属性上工作。添加

@Schema(type = "integer", format = "int64", example = "1560868939063") private Instant date;在一个类的一个领域。访问 /v3/api-docs 端点我可以看到该示例被完全忽略，它显示：

"MyClass":{"type":"object","properties":{"date":{"type":"integer","format":"int64"},...

编辑：似乎它被忽略了，因为字段的类型是 java.time.Instant，这意味着实际的 java 类属性类型，而不是 @Schema 中的“类型”属性。在例如 String 类型的字段上，它可以工作并显示示例。

使用弹簧引导 2.5：

api "org.springdoc:springdoc-openapi-ui:1.6.4"
api "org.springdoc:springdoc-openapi-data-rest:1.6.4"
api "org.springdoc:springdoc-openapi-security:1.6.4"

Answer 1

我的基本配置项目中有一个配置，它似乎覆盖了架构。虽然我不认为这是它应该如何工作的，但如果我删除它，它就可以工作。

SpringDocUtils.getConfig().replaceWithClass(Instant.class, Long.class);