Springfox Swagger：无法解析指针：/ definitions / Instant

Question

我们有一个SpringBoot项目，并且我们正在使用Springfox Swagger生成API文档。

有一个响应类，其中包含：

private Collection<Instant> quartzScheduledDates;

运行SwaggerUI时，我收到以下消息：

  

错误解析器错误位于   path./subscriptions/{subscriptionIdStr}.get.responses.200.schema.properties.quartzScheduledDates.items.$ref   由于以下原因而无法解析引用：无法解析指针：   / definitions / Instant在文档中不存在

我们正在使用Springfox Swagger 2.9.2，SpringBoot 2.1.2-RELEASE。

我也尝试过在springfox中使用Docket技巧，如Springfox Documentation所示：

    docket.directModelSubstitute(Instant.class, java.util.Date.class);

没有成功-相同的错误消息。

我在做什么错了？

Answer 1

我能够复制此问题。

可以通过在创建SWAGGER的Docket时定义新的 AlternateTypeRules 来解决此问题。

下面是代码段。

Docket docket= new Docket(DocumentationType.SWAGGER_2)
            .alternateTypeRules( AlternateTypeRules.newRule(
                    typeResolver.resolve(Collection.class, Instant.class),
                    typeResolver.resolve(Collection.class, Date.class), Ordered.HIGHEST_PRECEDENCE))
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.test"))
            .paths(PathSelectors.any())
            .build();

Answer 2

就我而言，我必须非常具体。我有：

TreeSet<ZonedDateTime>

然后我必须特别添加：

AlternateTypeRules.newRule(
    typeResolver.resolve(TreeSet.class, ZonedDateTime.class),
    typeResolver.resolve(TreeSet.class, Date.class), Ordered.HIGHEST_PRECEDENCE))

它与typeResolver中的父接口（例如：Collection，Set等）一起不工作。 （如果您不知道TypeResolver的来源，请使用@AutoWired。请参阅文档：https://springfox.github.io/springfox/docs/current/）