差点和后端打起来事情是这样的：今天我们公司的后端说他接口写完了，并分享了一个接口文档给我，如图所示，整个文档就只是展示接口的各种参数和响应，比较单一。。。让我感觉没啥安全感。。所以我按照了他分享的文档里的参数与响应数据，写到了我的前端页面上，由于时间比较紧急，前端这边简单自测了一下就匆匆上线了。。但是。。上线完当晚就炸了。。页面上各种接口报错：参数不存在参数类型错误接口不存在（是因为接口写错了）老板马上过来找我两，但是前后端开发人员各执一词：前端：我吊你，怎么你分享的接口文档这么多错误？后端：我吊你，你为什么没有测一测接口正不正常？前端：我为什么要测？你为什么不能确保你接口的正确性？后端：你为
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档1、Swagger是啥Swagger 是一个用于生成、描述和调用RESTful接口的Web服务。通俗的来讲，Swagger就是将项目中所有（想要暴露的）接口展现在页面上，并且可以进行接口调用和测试的服务。Swagger官网地址：https://swagger.io/2、Swagger有什么用？ Swagger有以下3个重要的作用：将项目中所有的接口展现在页面上，这样后端程序员就不需要专门为前端使用者编写专门的接口文档；当接口更新之后，只需要修改代码中的Swagger描述就可以实时生成新的接口文档了，从而规避了接口文档老旧不能使用的
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档1、Swagger是啥Swagger 是一个用于生成、描述和调用RESTful接口的Web服务。通俗的来讲，Swagger就是将项目中所有（想要暴露的）接口展现在页面上，并且可以进行接口调用和测试的服务。Swagger官网地址：https://swagger.io/2、Swagger有什么用？ Swagger有以下3个重要的作用：将项目中所有的接口展现在页面上，这样后端程序员就不需要专门为前端使用者编写专门的接口文档；当接口更新之后，只需要修改代码中的Swagger描述就可以实时生成新的接口文档了，从而规避了接口文档老旧不能使用的
目录引言方式1：BearerToken方式2：标准OAuth2授权码流程方式3：集成OIDC发现端点扩展：同时支持多种认证方式引言之前的文章讲过OAuth2体系，以授权码流程为例（参见下图），其中资源服务器（ResourceServer）作为服务的提供者，用户在客户端应用完成授权流程后，客户端应用需要携带AccessToken请求资源服务器，也即是要想访问资源服务器就需要提供正确的Authorization:BearerAccessToken，如此在将资源服务器接入SwaggerUI后，是无法直接访问其后端API的，例如直接访问会返回HttpStatus401，除非在SwaggerUI中接入正
目录引言方式1：BearerToken方式2：标准OAuth2授权码流程方式3：集成OIDC发现端点扩展：同时支持多种认证方式引言之前的文章讲过OAuth2体系，以授权码流程为例（参见下图），其中资源服务器（ResourceServer）作为服务的提供者，用户在客户端应用完成授权流程后，客户端应用需要携带AccessToken请求资源服务器，也即是要想访问资源服务器就需要提供正确的Authorization:BearerAccessToken，如此在将资源服务器接入SwaggerUI后，是无法直接访问其后端API的，例如直接访问会返回HttpStatus401，除非在SwaggerUI中接入正
前后端对接，就得有一个好的的接口文档，具体到：接口的名称，说明，入参字段，出参字段，是否必传，参数类型等等，这里记录一下使用的swaggerui组件knife4j-spring-ui。knife4j-spring-ui是swagger的一个增强版，相比官方ui，其界面更美观，功能更强大，字段说明更清晰直观，测试起来更方便对比一下：官方UI：全新UI：集成在sprintboot项目中使用Knife4j有两种方式：官网地址：Knife4j·集Swagger2及OpenAPI3为一体的增强解决方案.|Knife4j第一种：一、pom文件添加依赖com.github.xiaoyminknife4j-s
前后端对接，就得有一个好的的接口文档，具体到：接口的名称，说明，入参字段，出参字段，是否必传，参数类型等等，这里记录一下使用的swaggerui组件knife4j-spring-ui。knife4j-spring-ui是swagger的一个增强版，相比官方ui，其界面更美观，功能更强大，字段说明更清晰直观，测试起来更方便对比一下：官方UI：全新UI：集成在sprintboot项目中使用Knife4j有两种方式：官网地址：Knife4j·集Swagger2及OpenAPI3为一体的增强解决方案.|Knife4j第一种：一、pom文件添加依赖com.github.xiaoyminknife4j-s
今天我们来说说什么是Swagger？就是把相关的信息存储在它定义的描述文件里面（yml或json格式），再通过维护这个描述文件可以去更新接口文档，以及生成各端代码。而Springfox-swagger,则可以通过扫描代码去生成这个描述文件。好处：1、是一款让你更好的书写API文档的规范且完整框架。2、提供描述、生产、消费和可视化RESTfulWebService。3、是由庞大工具集合支撑的形式化规范。这个集合涵盖了从终端用户接口、底层代码库到商业API管理的方方面面。4，这个框架可以自动为你的业务代码生成restfut风格的api，而且还提供相应的测试界面，自动显示json格式的响应。大大方便
今天我们来说说什么是Swagger？就是把相关的信息存储在它定义的描述文件里面（yml或json格式），再通过维护这个描述文件可以去更新接口文档，以及生成各端代码。而Springfox-swagger,则可以通过扫描代码去生成这个描述文件。好处：1、是一款让你更好的书写API文档的规范且完整框架。2、提供描述、生产、消费和可视化RESTfulWebService。3、是由庞大工具集合支撑的形式化规范。这个集合涵盖了从终端用户接口、底层代码库到商业API管理的方方面面。4，这个框架可以自动为你的业务代码生成restfut风格的api，而且还提供相应的测试界面，自动显示json格式的响应。大大方便
swagger3接口文档 发布到服务器上时会出现的问题众所周知swagger很方便我们在接口上加个注解就能自动更新文档ui界面，这样就会出现一个问题，如果我把项目发到服务器上，正好我的服务器配置了用名称分流量的路由。这个时候我swagger默认的接口地址，就会少一层。例如我公司服务器 ip:port/project1是第一个项目；相同的ip:port/porject2是第二个项目。而整个路径中的project1和project2是在路由上体现的。我项目中是不会写servlet.context-path的。就是说我在本地访问swaggerui的地址是localhost:8080/swagger-
