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

Question

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

有一个响应类包含：

private Collection<Instant> quartzScheduledDates;

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

paths./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();