当前位置：主页 > 查看内容

Swagger2启动出现Unable to scan documentation context default

发布时间：2021-05-21 00:00| 有位朋友查看

简介：一、问题本地项目做了Swagger2的配置，在启动时报如下错误： DocumentationPluginsBootstrapper : Unable to scan documentation context default 测试的Controller文件： package com.quantsmart.controller;import com.quantsmart.model.R;import io.swag……

一、问题

本地项目做了Swagger2的配置，在启动时报如下错误：

DocumentationPluginsBootstrapper : Unable to scan documentation context default

测试的Controller文件：

package com.quantsmart.controller;

import com.quantsmart.model.R;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiImplicitParams;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.Authorization;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author: kaiyi
 * @Date 2021/5/21 13:57
 */
@RestController
@Api(tags = "CoinCommon里面的测试接口")
public class TestController {

    @GetMapping("/common/test")
    @ApiOperation(value = "测试方法", authorizations = {@Authorization("Authorization")})
    @ApiImplicitParams({
            @ApiImplicitParam(name = "param", value = "参数1", dataType = "String", paramType = "query", example = "paramValue"),
            @ApiImplicitParam(name = "param1", value = "参数2", dataType = "String", paramType = "query", example = "paramValue")
    })
    public R<String> testMethod(String param, String param2){
        return R.ok("ok,哈哈哈，测试哇");
    }

}

Swagger2配置

/config/swagger/SwaggerProperties.java


package com.quantsmart.config.swagger;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;

/**
 * @author: kaiyi
 * @Date 2021/5/20 16:50
 */
@Data
@ConfigurationProperties(prefix = "swagger2")
public class SwaggerProperties {

    /**
     * 是否开启swagger
     */
    private Boolean enabled;

    /**
     * 包扫描的路径
     */
    private String basePackage;

    /**
     * 联系人的名称
     */
    private String name ;

    /**
     * 联系人的主页
     */
    private String url ;

    /**
     * 联系人的邮箱
     */
    private String email ;

    /**
     * API的标题
     */
    private String  title  ;

    /**
     * API的描述
     */
    private String description ;

    /**
     * API的版本号
     */
    private String version ;

    /**
     * API的服务团队
     */
    private String termsOfServiceUrl ;

}

/config/swagger/SwaggerAutoConfiguration.java

package com.quantsmart.config.swagger;

import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.*;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spi.service.contexts.SecurityContext;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.Arrays;
import java.util.List;


/**
 * @author: kaiyi
 * @Date 2021/5/20 16:50
 */

@Configuration
@EnableSwagger2  // 开启swagger2自动生成api文档的功能
@EnableConfigurationProperties(SwaggerProperties.class)
public class SwaggerAutoConfiguration {

    private SwaggerProperties swaggerProperties;

    public SwaggerAutoConfiguration(SwaggerProperties swaggerProperties) {
        this.swaggerProperties = swaggerProperties;
    }

    @Bean
    public Docket docket() {
        Docket docket = new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage(swaggerProperties.getBasePackage()))
                .paths(PathSelectors.any())
                .build();
        // 安全的配置
        docket.securitySchemes(securitySchemes()) // 安全规则
                .securityContexts(securityContexts()); // 安全配置的上下问
        return docket;
    }

    /**
     * api 信息的简介
     *
     * @return
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().contact(
                new Contact(swaggerProperties.getName(), swaggerProperties.getUrl(), swaggerProperties.getEmail())
        )
                .title(swaggerProperties.getTitle())
                .description(swaggerProperties.getDescription())
                .version(swaggerProperties.getVersion())
                .termsOfServiceUrl(swaggerProperties.getTermsOfServiceUrl())
                .build();

    }

    /**
     * 安全的规则配置
     *
     * @return
     */
    private List<SecurityScheme> securitySchemes() {
        return Arrays.asList(new ApiKey("Authorization", "Authorization", "Authorization"));
    }

    /**
     * 安全的上下文
     *
     * @return
     */
    private List<SecurityContext> securityContexts() {
        return Arrays.asList(new SecurityContext(
                Arrays.asList(new SecurityReference("Authorization", new AuthorizationScope[]{new AuthorizationScope("global", "accessResource")})),
                PathSelectors.any()
        ));
    }




}

注意这里的apis(RequestHandlerSelectors.basePackage(swaggerProperties.getBasePackage())) 扫描的是 controller包，是产生下面错误的原因：

ERROR 4928 --- [           main] d.s.w.p.DocumentationPluginsBootstrapper : Unable to scan documentation context default
java.lang.NullPointerException: null
    at java.lang.String.startsWith(String.java:1405) ~[na:1.8.0_131]
    at java.lang.String.startsWith(String.java:1434) ~[na:1.8.0_131]
    at springfox.documentation.builders.RequestHandlerSelectors$4.apply(RequestHandlerSelectors.java:98) ~[springfox-core-2.9.2.jar:null]
    at springfox.documentation.builders.RequestHandlerSelectors$4.apply(RequestHandlerSelectors.java:95) ~[springfox-core-2.9.2.jar:null]
    at com.google.common.base.Present.transform(Present.java:75) ~[guava-20.0.jar:na]
    at springfox.documentation.builders.RequestHandlerSelectors$5.apply(RequestHandlerSelectors.java:114) ~[springfox-core-2.9.2.jar:null]
    at springfox.documentation.builders.RequestHandlerSelectors$5.apply(RequestHandlerSelectors.java:111) ~[springfox-core-2.9.2.jar:null]
    at com.google.common.base.Predicates$AndPredicate.apply(Predicates.java:384) ~[guava-20.0.jar:na]
    at com.google.common.base.Predicates$AndPredicate.apply(Predicates.java:384) ~[guava-20.0.jar:na]
    at com.google.common.collect.Iterators$6.computeNext(Iterators.java:617) ~[guava-20.0.jar:na]
    at com.google.common.collect.AbstractIterator.tryToComputeNext(AbstractIterator.java:145) ~[guava-20.0.jar:na]
    at com.google.common.collect.AbstractIterator.hasNext(AbstractIterator.java:140) ~[guava-20.0.jar:na]
    at springfox.documentation.spring.web.scanners.ApiListingReferenceScanner.scan(ApiListingReferenceScanner.java:48) ~[springfox-spring-web-2.9.2.jar:null]
    at springfox.documentation.spring.web.scanners.ApiDocumentationScanner.scan(ApiDocumentationScanner.java:67) ~[springfox-spring-web-2.9.2.jar:null]
    at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.scanDocumentation(DocumentationPluginsBootstrapper.java:101) [springfox-spring-web-2.9.2.jar:null]
    at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.start(DocumentationPluginsBootstrapper.java:167) [springfox-spring-web-2.9.2.jar:null]
    at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:182) [spring-context-5.2.6.RELEASE.jar:5.2.6.RELEASE]
    at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:53) [spring-context-5.2.6.RELEASE.jar:5.2.6.RELEASE]
    at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:360) [spring-context-5.2.6.RELEASE.jar:5.2.6.RELEASE]
    at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:158) [spring-context-5.2.6.RELEASE.jar:5.2.6.RELEASE]
    at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:122) [spring-context-5.2.6.RELEASE.jar:5.2.6.RELEASE]
    at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:894) [spring-context-5.2.6.RELEASE.jar:5.2.6.RELEASE]
    at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.finishRefresh(ServletWebServerApplicationContext.java:162) [spring-boot-2.2.7.RELEASE.jar:2.2.7.RELEASE]
    at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:553) [spring-context-5.2.6.RELEASE.jar:5.2.6.RELEASE]
    at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:141) [spring-boot-2.2.7.RELEASE.jar:2.2.7.RELEASE]
    at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:747) [spring-boot-2.2.7.RELEASE.jar:2.2.7.RELEASE]
    at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:397) [spring-boot-2.2.7.RELEASE.jar:2.2.7.RELEASE]
    at org.springframework.boot.SpringApplication.run(SpringApplication.java:315) [spring-boot-2.2.7.RELEASE.jar:2.2.7.RELEASE]
    at org.springframework.boot.SpringApplication.run(SpringApplication.java:1226) [spring-boot-2.2.7.RELEASE.jar:2.2.7.RELEASE]
    at org.springframework.boot.SpringApplication.run(SpringApplication.java:1215) [spring-boot-2.2.7.RELEASE.jar:2.2.7.RELEASE]
    at com.coin.TestCommonApplication.main(TestCommonApplication.java:12) [classes/:na]

二、解决方法

上边已经发现了问题了，如果我此时将apis(RequestHandlerSelectors.basePackage(swaggerProperties.getBasePackage()))改为我具体要扫描的包

apis(RequestHandlerSelectors.basePackage(“com.quantsmart.controller”))

此时重启，可以发现打印的日志中没出现上面的错误了，且DocumentationPluginsBootstrapper 中打印扫描到一个controller接口了。

上边的修改方法是直接写死的，所以，我们可以在配置文件中配置swaggerProperties.getBasePackage()这个controller包路径（即SwaggerProperties类中的basePackage属性），例如在 application.yml 配置文件中添加controller包路径


# Swagger2属性配置
swagger2:
  base-package: com.quantsmart.controller  # 需要指定扫描的包的路径

然后访问 http://localhost:8989/swagger-ui.html 页面，可以看到可以成功看到接口文档页面了：

本文转自网络，版权归原作者所有，原文链接：https://segmentfault.com/a/1190000040043197
本站部分内容转载于网络，版权归原作者所有，转载之目的在于传播更多优秀技术内容，如有侵权请联系QQ/微信：153890879删除，谢谢！

上一篇：CSS - background 下一篇：没有了

随机推荐

写给喜欢用DW编写CSS人的一些建议

在DreamWeaver中编写CSS,这种编写习惯并不提倡,不过由于可视化和操作简便,使用的...
HTML5 video循环播放多个视频的方法步骤

最近在开发中遇到的需求是：微信扫描课件二维码，播放其对应的课件视频设计流程...
HTML5 textarea高度自适应的两种方案

阅读全文你将获得以下解决方案。点击长文本编辑textarea，自动获得焦点随着输...
CSS实现鼠标滑过卡片上浮效果的示例

原理 hover 的时候对元素设置阴影：box-shadow，使其样式与常态不同。 box-shado...
css3弹性盒子flex实现三栏布局的实现

如题：高度已知，左右栏宽度300px，中间自适应：弹性盒子本身就是并排的，我们...
HTML5 FileReader对象的具体使用方法

写在前面前一篇文章介绍了HTML5中的Blob对象（详情戳这里），从中了解到Blob...
纯CSS让子元素突破父元素的宽度限制

在写样式中，我们可以经常看到这样的情况代码如下 div style=width: 300px;bord...
谈谈对css属性margin的理解

1.margin是什么？ margin用于控制元素周围空间的间隔，从视觉上达到空间间隔的目...
HTML里显示pdf、word、xls、ppt的方法示

1、PDF文件在线预览 1.HTML5新标签embed定义和用法 embed 标签定义嵌入的内容，...
css如何实现数字分页效果代码及步骤

相当数量的网站都使用数字分页效果，例如本站的分页也是采用此方式，还算是比较...

Swagger2启动出现Unable to scan documentation context default

一、问题

Swagger2配置

二、解决方法

推荐图文

网站制作之DreamWeaver入门及软件安装方法附软件下

如何在网站中插入天气预报

SOFAChannel#20 用安全计算保护关键业务

轻量级工具Vite到底牛在哪, 一文全知道

spring boot 整合 es 报错

关于页面元素的绝对定位和相对定位的一些理解

随机推荐

写给喜欢用DW编写CSS人的一些建议

HTML5 video循环播放多个视频的方法步骤

HTML5 textarea高度自适应的两种方案

CSS实现鼠标滑过卡片上浮效果的示例

css3弹性盒子flex实现三栏布局的实现

HTML5 FileReader对象的具体使用方法

纯CSS让子元素突破父元素的宽度限制

谈谈对css属性margin的理解

HTML里显示pdf、word、xls、ppt的方法示

css如何实现数字分页效果代码及步骤

关于我们