Springfox Swagger выбрасывает StackruError

Question

Я пытаюсь добавить springfox-swagger в мой проект Spring MVC. У меня есть следующая конфигурация:

@Configuration
@EnableSwagger2
@ComponentScan(basePackageClasses = com.mycompany.MyCtrl.class)
public class SpringFoxConfig {

    @Autowired
    private TypeResolver typeResolver;

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2);
    }
}

@Configuration
@EnableWebMvc
@EnableCaching
@EnableAspectJAutoProxy(proxyTargetClass = true)
@ComponentScan(basePackageClasses = { ApplicationConfig.class, AppConfig.class})
@Import(SpringFoxConfig.class)
public class ApplicationConfig extends WebMvcConfigurerAdapter implements CachingConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
}

Но после развертывания я не могу получить доступ к каким-либо контроллерам, и через 1-5 минут я получаю следующую трассировку стека:

 2015-12-24 18:26:46,297 ERROR [org.springframework.web.context.ContextLoader] (MSC service thread 1-5) Context initialization failed: com.google.common.util.concurrent.ExecutionError: java.lang.StackruError

 at springfox.documentation.spi.schema.contexts.ModelContext.hasSeenBefore(ModelContext.java:156) [springfox-spi-2.3.0.jar:2.3.0]

 at springfox.documentation.spi.schema.contexts.ModelContext.parentHasSeenBefore(ModelContext.java:174) [springfox-spi-2.3.0.jar:2.3.0]
at springfox.documentation.spi.schema.contexts.ModelContext.hasSeenBefore(ModelContext.java:157) [springfox-spi-2.3.0.jar:2.3.0]

Без springfox мои контроллеры работают хорошо. Что я делаю не так?

Answer 1

Я видел такое поведение, когда у вас есть DTO master-details с двунаправленными ссылками:

class Master {
    List<Detail> details;
}

class Details {
    Master master;
}

Обходной путь для этой проблемы должен добавить hidden = true приписывать @ApiParam аннотация на параметры таких типов:

ResponseEnitity<?> controller(@ApiParam(hidden = true) @RequestBody Master master) {
}

Я считаю, что это ошибка в Springfox, но у меня еще не было возможности сообщить об этом.