使用spring boot运行swagger2时出现stackoverflowError

Question

我用 spring boot 配置了 swagger2。 在小项目中效果很好。 但是在有很多休息的大项目中会导致 stackOverflowError。

招摇配置：

@Configuration
@EnableSwagger2
public class SwaggerConfiguration {

@Bean
public Docket api(){
    return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.basePackage("org.dordas.swagger.web.controller"))
            .paths(PathSelectors.ant("/api/**"))
            .build();
}
}

错误：

org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper';
nested exception is com.google.common.util.concurrent.ExecutionError: java.lang.StackOverflowError
at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:176)

Answer 1

控制器中的某些实体参数相互引用，这会导致 swagger 中的无限递归（例如使用休眠时实体中的 Set 类型属性）。

=> 使用@ApiIgnore忽略实体参数，并使用@ApiImplicitParams来描述您的参数

Answer 2

也许您在注释中有语法，例如@ApiParam(allowableValues = "range[0-3276843]")，“范围”是错误的。