温馨提示×

温馨提示×

您好,登录后才能下订单哦!

密码登录×
登录注册×
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》

Swagger2配置方式以及如何解决404报错

发布时间:2021-11-08 12:50:17 来源:亿速云 阅读:1195 作者:柒染 栏目:开发技术

Swagger2配置方式以及如何解决404报错,针对这个问题,这篇文章详细介绍了相对应的分析和解答,希望可以帮助更多想解决这个问题的小伙伴找到更简单易行的方法。

    Swagger2配置

    在spring boot项目中配置Swagger2,配置好了但是访问确实404,SwaggerConfig中的注入方法也执行了还是访问不到页面。究其原因是MVC没有找到swagger-ui包中的swagger-ui.html文件。

    Swagger2的配置步骤如下:

    一、引入依赖

    pom.wml

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

    二、编写配置文件

    package io.github.talelin.latticy.config; import com.google.common.base.Function; import com.google.common.base.Optional; import com.google.common.base.Predicate; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.EnableWebMvc; import springfox.documentation.RequestHandler; import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.builders.PathSelectors; import springfox.documentation.service.ApiInfo; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket; import springfox.documentation.swagger2.annotations.EnableSwagger2; @Configuration @EnableSwagger2 public class SwaggerConfig {     // 定义分隔符     private static final String splitor = ";";     @Bean     Docket docket() {         System.out.println("Swagger===========================================");         return new Docket(DocumentationType.SWAGGER_2)                 .apiInfo(apiInfo())                 .select()                 .apis(basePackage("io.github.talelin.latticy.controller.v1"))	//这里采用包扫描的方式来确定要显示的接口                 // .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))                         //这里采用包含注解的方式来确定要显示的接口                 .paths(PathSelectors.any())                 .build();     }     private ApiInfo apiInfo() {         return new ApiInfoBuilder()                 .title("CMS")                 .description("电商小程序 CMS Api文档")                 .termsOfServiceUrl("https://blog.csdn.net/xfx_1994")                 .version("1.0")                 .build();     }     public static Predicate <RequestHandler> basePackage(final String basePackage) {         return input -> declaringClass(input).transform(handlerPackage(basePackage)).or(true);     }     private static Function <Class<?>, Boolean> handlerPackage(final String basePackage)     {         return input -> {             // 循环判断匹配             for (String strPackage : basePackage.split(splitor)) {                 boolean isMatch = input.getPackage().getName().startsWith(strPackage);                 if (isMatch) {                     return true;                 }             }             return false;         };     }     private static Optional<? extends Class<?>> declaringClass(RequestHandler input) {         return Optional.fromNullable(input.declaringClass());     } }

    至此已经配置完成,启动项目访问 http://localhost: p o r t / {port}/ port/{context-path}/swagger-ui.html

    如果访问成功则不需要继续下面的配置,如果访问失败出现404报错,则进行下面的配置

    Swagger2配置方式以及如何解决404报错

    三、解决404报错

    package io.github.talelin.latticy.config; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; @Configuration public class WebMvcConfig implements WebMvcConfigurer {     @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/");     } }

    原理就是帮助MVC找到 swagger-ui.html 及其 CSS,JS 对应的文件

    swagger配置好后仍然404问题

    记录一下 学习spring boot 遇到的问题

    swagger2

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

    swagger 添加此配置之后仍然404

    1.有可能是 有其他类 实现了 WebMvcConfigurer 或者 继承了 WebMvcConfigurationSupport

    导致的WebMvcConfigurationSupport 在继承的时候 没有重写addResourceHandlers

    2.spring boot 启动模式有三种 如果默认没有改动的话 应该是SERVLET

    • NONE

    • SERVLET

    • REACTIVE

    注意查看 只有SERVLET 会加载webmvc配置

    关于Swagger2配置方式以及如何解决404报错问题的解答就分享到这里了,希望以上内容可以对大家有一定的帮助,如果你还有很多疑惑没有解开,可以关注亿速云行业资讯频道了解更多相关知识。

    向AI问一下细节

    免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

    AI