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

Question

我们有一个 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 文档中所示：

    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( &nbsp;&nbsp;&nbsp;&nbsp;typeResolver.resolve(TreeSet.class,&nbsp;ZonedDateTime.class), &nbsp;&nbsp;&nbsp;&nbsp;typeResolver.resolve(TreeSet.class,&nbsp;Date.class),&nbsp;Ordered.HIGHEST_PRECEDENCE))它不适用于 typeResolver 中的父接口，例如：Collection、Set等。（顺便说一下，TypeResolver 是@AutoWired，如果您想知道它来自哪里。请参阅文档：https&nbsp;://springfox.github.io/springfox/docs/current/ ）