斯威格路线返回404春装运动衫

Question

我正试图将Swagger添加到现有的spring boot应用程序中，如本教程所述。

我的主要应用课程如下：

@SpringBootApplication
@EnableAutoConfiguration
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

斯威格配置是：

@Configuration
@EnableSwagger2
public class SwaggerConfiguration {
    @Bean
    public Docket api() { 
        return new Docket(DocumentationType.SWAGGER_2)
       .select()
        .apis(RequestHandlerSelectors.any())
        .paths(PathSelectors.any())
        .build();                                           
    }
}

我可以在启动日志中看到Spring显然识别了Swagger和它的路线：

s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/v2/api-docs],methods=[GET],produces=[application/json || application/hal+json]}" onto public org.springframework.http.ResponseEntity<springfox.documentation.spring.web.json.Json> springfox.documentation.swagger2.web.Swagger2Controller.getDocumentation(java.lang.String,javax.servlet.http.HttpServletRequest)
s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/configuration/ui]}" onto org.springframework.http.ResponseEntity<springfox.documentation.swagger.web.UiConfiguration> springfox.documentation.swagger.web.ApiResourceController.uiConfiguration()
s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/configuration/security]}" onto org.springframework.http.ResponseEntity<springfox.documentation.swagger.web.SecurityConfiguration> springfox.documentation.swagger.web.ApiResourceController.securityConfiguration()
s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/swagger-resources]}" onto org.springframework.http.ResponseEntity<java.util.List<springfox.documentation.swagger.web.SwaggerResource>> springfox.documentation.swagger.web.ApiResourceController.swaggerResources()

但是当试图访问http://localhost:8080/v2/api-docs时，我得到一个普通的404作为响应。

我在网上能找到的所有类似问题都是指人们不使用Spring Boot，必须手动映射资源（也在同一教程链接中描述），但我的情况并非如此。

有没有办法解决这个问题，或者——至少——从哪里着手调查？

Answer 1

我发现问题与jersey的应用程序路径配置有关。在我的例子中，通过以下注释：

@Component
@ApplicationPath("/") //WRONG
@Configuration
public class JerseyConfiguration extends ResourceConfig {
...
}

@ApplicationPath配置会覆盖Jersey本身发布的任何路由（比如白标签/error）或第三方库（在本例中是/v2/api docs，/configuration/ui，/configuration/security和来自swagger的/swagger resources）。简单地将/作为路径迫使严格使用我的应用程序中的自定义控制器来解析请求。

将@ApplicationPath限制为应用程序所服务的实际路径（在我的例子中是/api）将允许jersey将其他路由绑定到自动生成的控制器：

@Component
@ApplicationPath("/api") //RIGHT
@Configuration
public class JerseyConfiguration extends ResourceConfig {
...
}