spring应用：为什么swagger-ui不能在swagger-resources/configuration/UI上做HTTP GET？

Question

我一直在尝试用我的spring REST应用程序设置swagger-ui。我使用的是spring 4.2.6.Release和swagger core&ui 2.5.0。我不是在使用swagger注释，期待swagger拿起spring REST注释。

我可以让swagger生成api文档，并且可以在V2/API-Docs下查看它。

我可以点击swagger-ui.html页面，但它没有在页面上显示任何api-docs或控制器信息。在浏览器上启用调试器模式时，我看到它是错误输出，同时尝试获取“swagger-resources/configuration/ui”-返回404（未找到）。

我遵循了下面的链接来设置swagger-ui http://www.baeldung.com/swagger-2-documentation-for--rest-api

我最初设置了上面链接中指定的资源处理程序，但这也没有帮助，并且给了我同样的404错误。我试着调整了资源处理程序，看看它是否可以帮助swagger-ui在swagger-resources/configuration/UI上执行GET操作。

为什么swagger-ui不能获得资源swagger-resources/configuration/UI？

我已经按照下面的方式设置了我的资源处理程序。

大摇大摆的配置

@Configuration
@EnableSwagger2
public class SwaggerConfiguration {

@Bean
public Docket api(){
    return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.any())
            .paths(PathSelectors.any())
            .build();
            //.apiInfo(apiInfo());
}
}

Web配置文件

@EnableWebMvc
@Configuration
@Import(SwaggerConfiguration.class)
@ComponentScan("com.bank.direct.services")

public class WebConfig extends WebMvcConfigurerAdapter {

@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> pConverters) {
    pConverters.add(RestUtils.getJSONMessageConverter());
}

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

}

我确实为webapp设置了SecurityConfig,但我将其设置为最小值,以防止可能导致任何问题。

@EnableWebSecurity
@EnableGlobalMethodSecurity(prePostEnabled = true)
@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {


@Autowired
private AuthenticationService _authenticationService;


@Autowired
public void globalUserDetails(AuthenticationManagerBuilder pAuth) throws Exception {

    pAuth.userDetailsService(_authenticationService);
}


@Override
protected void configure(HttpSecurity pHttp) throws Exception {

    // Enable HTTP caching
    pHttp.headers().cacheControl().disable();

    // Configure security
    pHttp.httpBasic()

    // -- Allow unauthenticated request (must be done before allowing only authenticated requests)
    .and()
    .authorizeRequests()
    .antMatchers("/rest/application/information/").permitAll();

}

当应用程序启动时，我确实看到了一些资源映射

2016-08-31 11:24:55信息[localhost-startStop-1]RequestMappingHandlerMapping-将“{[/v2/api-docs],methods=[GET],produces=[application/json application/hal+json]}”映射到公共org.springframework.http.responseEntity springfox.documentation.swagger2.web.swagger2controller.getDocumentation（java.lang.string,javax.servlet.http.httpservletRequest）2016-08-31 11:24:55.http.responseEntity springfox.documentation.swagger.web.apiResourceController.uiconfiguration（）

Answer 1

假设您严格遵循了这一指南（http://www.baeldung.com/swagger-2-documentation-for--rest-api）,那么您的swagger依赖项将会得到不同的版本,这似乎导致了404（至少对我来说...）

尝试更改springfox-swagger-ui依赖项的版本以匹配springfox-swagger2。

我使用了以下内容（指南将swagger-ui作为2.4.0):

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.6.1</version>
</dependency>

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.6.1</version>
</dependency>