swagger3介入springboot访问不到的问题

主要关注点要区分于swagger2


1、swagger2 需要引用包的数量为2

  <dependency>
  	<groupId>io.springfox</groupId>
   	<artifactId>springfox-swagger2</artifactId>
    <version>版本</version>
  </dependency>
  <dependency>
  	<groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>版本</version>
  </dependency>
同时,在启动类上,增加@EnableSwagger2;


配置swagger的文档类;**必要的时候访问不到资源,需要重新设定静态资源的位置。**
@Configuration
public class SwaggerConfig extends ***WebMvcConfigurerAdapter*** {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("示例API")
                .description("这是一个示例API的描述")
                .version("1.0")
                .build();
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
		//注册的是swagger jar包的静态资源的位置
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/springfox-swagger-ui");

        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }

}

2、swagger3 配置jar为3个,多了一个springfox-boot-starter 的jar包
<dependency>
	<groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>
//修改使用的docket类型
@Bean
    public Docket api() {
        return new Docket(DocumentationType.OAS_30)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }

可能会在启动的时候出现启动错误的问题
springboot 2.6.* 版本核swagger 3.0版本的兼容问题
org.springframework.context.ApplicationContextException:Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
Caused by: java.lang.NullPointerException: null
原文链接:https://blog.csdn.net/wenquan19960602/article/details/131132978

你可能感兴趣的:(spring,boot,后端,java)