Springdoc openapi 3 @Schema示例被忽略

Question

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

@架构（type="integer"， form="int64"， example="1560868939063"）私有即时日期；在类的字段上。访问 /v3/api-docsendpoint，我可以看到该示例被完全忽略了，它显示：

＜code＞“MyClass”：｛“type”：“object”，“properties”：｛”date“：｛”type“：”integer“，”format“：”int64“｝

EDIT:好像被忽略了，因为字段的类型是java.time.Instant，意思是实际的java类属性类型，而不是@Schema中的“type”属性。在字符串类型的字段上，它工作并显示示例。

使用Spring Boot2.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

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

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