Springboot下swagger-ui.html访问不到的解决⽅案⽬录
Springboot swagger-ui.html访问不到
问题
解决⽅法
swagger-ui的坑，swagger-ui.html⽆显⽰
现在说这个问题导致的原因，以及解决⽅案
Springboot swagger-ui.html访问不到
问题
在前⾯的Swagger2的基本配置中是可以访问到swagger-ui.html的
但当⾃定义继承配置WebMvcConfigurationSupport后便⽆法访问到该页⾯，原因参考请看参考资料。
⾸先看我的⾃定义配置,
springboot和过滤器*************
* HttpMessageConverter转换处理
* 处理转义hmtl标签为正常的hmtl标签
*@*********************
*
*/
@Configuration
public class WebConfig extends WebMvcConfigurationSupport {
@Bean
public MappingJackson2HttpMessageConverter customJackson2HttpMessageConverter() {
MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();
ObjectMapper objectMapper = new ObjectMapper();
DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
new JsonSerializer<Object>() {
@Override
public void serialize(Object value, JsonGenerator jgen,
SerializerProvider provider) throws IOException,
JsonProcessingException {
jgen.writeString("");
}
});
// 进⾏HTML解码
String.class, new JsonSerializer<String>() {
@Override
public void serialize(String value, JsonGenerator jgen,
SerializerProvider provider) throws IOException,
JsonProcessingException {
jgen.writeString(StringEscapeUtils.unescapeHtml4(value));
}
}));
jsonConverter.setObjectMapper(objectMapper);
return jsonConverter;
}
@Override
public void configureMessageConverters(
List<HttpMessageConverter<?>> converters) {
converters.add(customJackson2HttpMessageConverter());
super.addDefaultHttpMessageConverters(converters);
}
}
如果我把该⽂件全部注释掉则会正常显⽰，否则⽆法访问到swagger-ui.html，
解决⽅法
如果继承了WebMvcConfigurationSupport，则在配置⽂件在中配置的相关内容会失效，需要重新指定静态资源
因此参照资料2我做了处理如下，在该代码的末尾加上静态资源配置
代码加在
*************
* HttpMessageConverter转换处理
* 处理转义hmtl标签为正常的hmtl标签
*@*********************
*
*/
@Configuration
public class WebConfig extends WebMvcConfigurationSupport {
@Bean
public MappingJackson2HttpMessageConverter customJackson2HttpMessageConverter() {
MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();
ObjectMapper objectMapper = new ObjectMapper();
DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
new JsonSerializer<Object>() {
@Override
public void serialize(Object value, JsonGenerator jgen,
SerializerProvider provider) throws IOException,
JsonProcessingException {
jgen.writeString("");
}
});
// 进⾏HTML解码
String.class, new JsonSerializer<String>() {
@Override
public void serialize(String value, JsonGenerator jgen,
SerializerProvider provider) throws IOException,
JsonProcessingException {
jgen.writeString(StringEscapeUtils.unescapeHtml4(value));
}
}));
jsonConverter.setObjectMapper(objectMapper);
return jsonConverter;
}
@Override
public void configureMessageConverters(
List<HttpMessageConverter<?>> converters) {
converters.add(customJackson2HttpMessageConverter());
super.addDefaultHttpMessageConverters(converters);
}
/**
* 发现如果继承了WebMvcConfigurationSupport，则在yml中配置的相关内容会失效。需要重新指定静态资源 *
* @param registry
*/
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/**").addResourceLocations(
"classpath:/static/");
registry.addResourceHandler("swagger-ui.html").addResourceLocations(
"classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**").addResourceLocations(
"classpath:/META-INF/resources/webjars/");
super.addResourceHandlers(registry);
}
/**
* 配置servlet处理
*/
@Override
public void configureDefaultServletHandling(
DefaultServletHandlerConfigurer configurer) {
}
}
swagger-ui的坑，swagger-ui.html⽆显⽰
且返回200⽆报错，且/v2/api-docs可以正常访问
因为粗⼼，踩中的坑，代码规范，细⼼真的能节省很多时间
上图，界⾯显⽰如图，⼀切都正常，控制台，也没有报错，很诡异吧
docs却可以正常访问，包括接⼝，都是正常的，⽹上很多解决⽅案都是说，跨域问题，或者是静态资源访问不到
1，⾸先跨域问题，会报错，有很明显的报错提⽰，这⾥排除，
2，静态资源，可以参考csdn上的其他⽅案很多，排查⽅法，可以查看targer⽬录下是否有静态⽂件
现在说这个问题导致的原因，以及解决⽅案
由于当时再写相关代码，⾥⾯还涉及到过滤器，⽹上说到swagger会和有冲突，所以⼀直错误认为是导致的问题，⽽且还有fastdfs的相关代码，也有说这两个起冲突，没办法，⼀⼀排查，进⾏版本回滚，发现fasdfs这个版本没有问题，这⾥要说，平时开发⼀定要切分⽀，分⽀切不了也要多提交版本，这样⼀旦出现问题也好解决。
然后下个版本发现，加上，问题就⼜出现了，把所有代码注释掉，问题依旧，百思不得其解，⽆奈，地毯扫描，版本不⼀样的全部注释，直到注释到controller层，⼜正常了，⾮常怀疑，⼀个co
ntroller，service业务代码这些不应该导致出问题的，怎么会是这的问题，然后进⼊代码准备细查，打开代码惊喜就来了
这是代码，本来还准备去看service层，看下是不是业务上有什么代码报错，到这就感觉更奇怪了，什么代码都没写，去掉就正常了，然后搜⼀下是不是⽅法名重复了，发现没有，
这时发现：@RequestMapping()，对就是这个注解，⾥⾯没东西是什么⿁，估计是当时注释的时候直接给删掉了，加⼊值后⼀切恢复正常
现在想想，swagger本来就是对controller的提取，没有报错就可以怀疑接⼝问题。
以上为个⼈经验，希望能给⼤家⼀个参考，也希望⼤家多多⽀持。
发表评论