近期一个spring boot的RESTful项目要用到swagger2,运行的时候发现访问/swagger-ui.html报404错误,当我去掉@EnableMvc之后就可以访问了,但去掉@EnableMvc又会导致其他功能出问题。
一开始以为是@EnableSwagger2跟@EnableMvc冲突了,swagger的模块没有加载到,但是/v2/api-docs访问是OK的。应该是静态资源访问的问题,后来看到github上有外国友人也在讨论这个问题 https://github.com/springfox/springfox/issues/776
以为新版本已经解决,我尝试将版本号 2.2.2 升到 2.7,还是没有解决问题。
后来找了一下,可能是@EnableMvc把默认的静态资源路径覆盖了,所以尝试了手动设置的方式,问题解决了,代码如下:
@Configuration
@EnableSwagger2
@Profile({ "dev", "test" })
public class MySwagger2 extends WebMvcConfigurerAdapter {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.xuanyuan"))
.paths(PathSelectors.any())
.build();
}
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/**").addResourceLocations("classpath:/META-INF/resources/").setCachePeriod(0);
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("Spring Boot中使用Swagger2构建RESTful APIs")
.description("更多Spring Boot相关文章请关注:http://blog.didispace.com/")
.termsOfServiceUrl("http://blog.didispace.com/")
.contact("程序猿DD")
.version("1.0")
.build();
}
}