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

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

有一个响应类包含：

private Collection<Instant> quartzScheduledDates;

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

错误解析器错误位于 路径./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文档 https://springfox.github.io/springfox/docs/current/:

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

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

我究竟做错了什么？

I was able to replicate this issue.

这可以通过定义新的来解决替代类型规则为您的 SWAGGER 创建 Docket 时。

下面是片段。

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();