`

swagger报错No operations defined in spec!解决

    博客分类:
  • java
 
阅读更多

swagger报错No operations defined in spec! 一般有2个原因:

  1. basePackage错误;
  2. path错误;

其中第2个path错误,path要是全匹配url,url是完整的,包含方法的url,本人因为path只写controller上的url,没写方法上的url,找了1天也没找到原因,看之前项目才发现url不是完整的url;如果不是完整的url,正则是/path/rest/pic/.*, 正则是 .*;

 

第1个basePackage错误,主要是扫描的包内没有controller,或者controller类上没有@Controller注解。

 完整可用的配置类如下:

 

@Configuration
@EnableSwagger2
public class Swagger2Config {
    @Value("${swagger.enable}")
    boolean swagger2enable;

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .enable(swagger2enable)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.test.controller"))
                .paths(doFilteringRules())
                .build();
    }

    private Predicate<String> doFilteringRules() {
 //       return PathSelectors.any();
 //       return PathSelectors.regex("/report/.*");
//		return Predicates.not(PathSelectors.regex("/error.*"));
//		return or(regex("/hello.*"), regex("/rest/adxSspFinanceManagement.*"));//success
        return or(regex("/rest/pic/url/query"),  //此处必须为完整的url,到方法级别
                regex("/rest/text/url/query/.*") //部分url的正则是 .*
//                regex("/api/v1/pop/bms/audit/.*")
        );
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Check APIs")
                .description(" 测试环境地址:http://10.179.88.216:8083")
                .termsOfServiceUrl("http://10.179.88.216:8083")
                .contact("开发团队")
                .version("1.0")
                .build();
    }

}

 

分享到:
评论

相关推荐

    flask-restx:Flask-RESTPlus的Fork:功能齐全的框架,用于通过Flask快速,轻松地进行文档化的API开发

    2. **自动文档**:借助内置的Swagger UI集成,Flask-RESTX允许开发者以JSON格式定义API规范,并自动生成交互式文档。Swagger UI是一个流行的工具,可以直观地展示API的结构、参数和响应,方便测试和调试。 3. **...

    swagger-spec:Swagger 2.0定义的规范

    Swagger 2.0 是一个广泛使用的开放源代码框架,用于设计、构建、文档化和使用 RESTful 风格的 Web 服务。它基于 OpenAPI Specification(OAS),旨在简化 API 的开发、测试和维护。Swagger 2.0 的核心是 JSON 格式的...

    解决环信导入源码后io.swagger的导入报错

    本篇文章将详细讲解如何解决“环信导入源码后io.swagger的导入报错”的问题。 首先,我们需要了解环信(Easemob)的基本概念。环信是一家提供即时通讯云服务的公司,为开发者提供了丰富的SDK,包括Android、iOS、...

    io.swagger.client环信报错.zip

    引用两个文件,解决import io.swagger.client.ApiException; import io.swagger.client.api.MessagesApi; import io.swagger.client.model.Msg;报错

    解决环信io.swagger.client.ApiException包报错

    解决环信io.swagger.client.ApiException包报错以及环信默认包导入工程后的报错问题

    springboot - 2.7.3版本 - (三)整合Swagger3

    Swagger3则是用于构建RESTful API的API文档工具,它允许开发者通过注解来描述API,生成交互式的文档,极大地提高了前后端联调的效率。在SpringBoot项目中整合Swagger3,可以实现自动化接口文档的生成,为团队协作...

    环信io.swagger.client报错.zip

    在这个场景中,我们将深入探讨如何解决环信Java版本集成时`io.swagger.client`报错的问题。 首先,`io.swagger.client`是Swagger的一个客户端库,用于生成和处理RESTful API的请求。在集成环信时,我们可能需要用到...

    swagger-parser:将Swagger Spec转换为Java POJO

    注意:如果您正在寻找swagger-parser 1.X和OpenAPI 2.0,请参考 目录 总览 这是Swagger Parser项目,该项目将JSON或YAML格式的OpenAPI定义解析为表示形式,返回任何验证警告/错误。 它还提供了一个简单的框架,...

    swagger-spec-validator:使用swagger.io在线验证器验证OpenAPISwagger API规范

    入门实例要从命令行使用swagger-spec-validator ,只需将其与规范文件一起调用以作为参数进行验证: $ swagger-spec-validator swagger.yaml 如果未提供任何参数,则将从stdin读取规范。 swagger-spec-validator可以...

    SpringBoot集成Swagger3(powernode document)源代码

    2.9 解决报错 2.9.1 报错1 2.9.1.1 报错信息 2.9.1.2 解决报错办法 2.9.2 报错2 2.9.2.1 报错信息2 2.9.2.2 解决报错方法 2.9.3 修改后的application.yml文件 2.10 测试访问文档页面 2.11 测试接口 2.12 补充注解...

    项目API文档在线自动生成 Swagger UI.zip

    Swagger UI是一款RESTFUL接口的文档在线自动生成 功能测试功能软件。 现在多数的项目开发中,网站和移动端都需要进行数据交互和对接,这少不了使用REST编写API接口这种场景。例如有些团队,移动端交由了另一团队...

    swagger_spec_validator

    swagger_spec_validator关于Swagger Spec验证器是一个Python库,可根据或规范验证Swagger规范。 验证者旨在检查是否完全符合规范。用法示例验证网址规范: from swagger_spec_validator import validate_spec_url# ...

    springboot整合swagger-bootstrap-ui,过滤器放开并解决自定义错误信息返回冲突-DEMO

    springboot整合swagger-bootstrap-ui,过滤器放开并解决自定义错误信息返回冲突-DEMO

    swagger所有相关jar包

    Swagger是一个流行的API开发...总结来说,Swagger和Springfox提供了一套完整的解决方案,帮助开发者高效地设计、文档化和测试RESTful API,提升开发效率和API的质量。无论你是API的提供者还是消费者,都能从中受益。

    swagger_ui+spec文件

    Swagger UI 是一个强大的工具,用于展示和交互式测试基于 Swagger 规范(OpenAPI Specification)的 RESTful API。这个资源包含 `swagger.yaml` 文件和 `swagger-ui-2.2.10.zip` 文件,它们是Swagger框架的重要组成...

    swagger静态部分文件打包

    Swagger 是一个广泛使用的 API 设计和开发工具,它允许开发者以 YAML 或 JSON 格式定义 RESTful 风格的 Web 服务接口。这个压缩包文件 "swagger" 可能包含了 Swagger 的静态资源,这些资源主要用于展示和测试 API ...

    swagger2Demo,swagger

    Swagger是一个强大的API开发工具,主要用于设计、构建、文档化和使用RESTful web服务。在这个名为"swagger2Demo"的项目中,我们看到作者利用Swagger 2创建了一个演示应用,目的是为了展示如何使用Swagger来调试接口...

    swagger2.zip

    -- 解决进入swagger页面报类型转换错误,排除2.9.2中的引用,手动增加1.5.21以上版本,这里选1.6.0版本--&gt; &lt;groupId&gt;io.swagger &lt;artifactId&gt;swagger-annotations &lt;version&gt;1.6.0 &lt;!-- ...

    swagger解决中文缺失使用字体文件

    本文将详细讲解如何利用提供的字体文件`KaiGenGothicCN-Regular-Italic.ttf`、`KaiGenGothicCN-Bold-Italic.ttf`、`KaiGenGothicCN-Regular.ttf`和`KaiGenGothicCN-Bold.ttf`来解决Swagger中的中文缺失问题。...

    关于@EnableSwagger2报错的正常使用demo

    这篇教程将深入探讨如何正确配置和使用Swagger2,以避免或解决这些错误。 首先,我们需要理解@EnableSwagger2的作用。这个注解是Swagger2提供的,用于启动Spring Boot应用中的Swagger2功能。它告诉Spring Boot应用...

Global site tag (gtag.js) - Google Analytics