本文分享自天翼云开发者社区@《Springfox与SpringDoc——swagger如何选择（SpringDoc入门）》，作者:才开始学技术的小白 0.引言之前写过一篇关于swagger（实际上是springfox）的使用指南（https://www.ctyun.cn/developer/article/371704742199365），涵盖了本人在开发与学习的时候碰到的各种大坑。但由于springfox已经不更新了，很多项目都在往springdoc迁移笔者也是花了一些时间试了一下这个号称“把springfox按在地下摩擦”的springdoc究竟好不好使，本文就来简单介绍下spring
今天使用Gateway整合微服务的文档的时候发现Knife4j文档请求异常，查看数据包发现请求了这样的一个路径。（省流助手：错误原因是获取api-doc的方法错误，如果不明白我在说什么，那么可以往下看看）整合的代码是在网上直接CV的，看来是需要做一些修改，其中比较重要的是在gateway的两个配置，其他服务的配置文件和单机时一致。gateway的配置文件如下：第一个是Config@Slf4j@Component@Primary@AllArgsConstructorpublicclassSwaggerResourceConfigimplementsSwaggerResourcesProvider
今天使用Gateway整合微服务的文档的时候发现Knife4j文档请求异常，查看数据包发现请求了这样的一个路径。（省流助手：错误原因是获取api-doc的方法错误，如果不明白我在说什么，那么可以往下看看）整合的代码是在网上直接CV的，看来是需要做一些修改，其中比较重要的是在gateway的两个配置，其他服务的配置文件和单机时一致。gateway的配置文件如下：第一个是Config@Slf4j@Component@Primary@AllArgsConstructorpublicclassSwaggerResourceConfigimplementsSwaggerResourcesProvider
Swagger定义Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。Swagger让部署管理和使用功能强大的API从未如此简单。SpringFox的Swagger库之前在SpringBoot项目中一直使用的是SpringFox提供的Swagger库，上了下官网发现已经有接近两年没出新版本了！前几天升级了SpringBoot2.6.x版本，发现这个库的兼容性也越来越不好了，有的常用注解属性被废弃了居然都没提供替代！ht
Swagger定义Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。Swagger让部署管理和使用功能强大的API从未如此简单。SpringFox的Swagger库之前在SpringBoot项目中一直使用的是SpringFox提供的Swagger库，上了下官网发现已经有接近两年没出新版本了！前几天升级了SpringBoot2.6.x版本，发现这个库的兼容性也越来越不好了，有的常用注解属性被废弃了居然都没提供替代！ht
差点和后端打起来事情是这样的：今天我们公司的后端说他接口写完了，并分享了一个接口文档给我，如图所示，整个文档就只是展示接口的各种参数和响应，比较单一。。。让我感觉没啥安全感。。所以我按照了他分享的文档里的参数与响应数据，写到了我的前端页面上，由于时间比较紧急，前端这边简单自测了一下就匆匆上线了。。但是。。上线完当晚就炸了。。页面上各种接口报错：参数不存在参数类型错误接口不存在（是因为接口写错了）老板马上过来找我两，但是前后端开发人员各执一词：前端：我吊你，怎么你分享的接口文档这么多错误？后端：我吊你，你为什么没有测一测接口正不正常？前端：我为什么要测？你为什么不能确保你接口的正确性？后端：你为
差点和后端打起来事情是这样的：今天我们公司的后端说他接口写完了，并分享了一个接口文档给我，如图所示，整个文档就只是展示接口的各种参数和响应，比较单一。。。让我感觉没啥安全感。。所以我按照了他分享的文档里的参数与响应数据，写到了我的前端页面上，由于时间比较紧急，前端这边简单自测了一下就匆匆上线了。。但是。。上线完当晚就炸了。。页面上各种接口报错：参数不存在参数类型错误接口不存在（是因为接口写错了）老板马上过来找我两，但是前后端开发人员各执一词：前端：我吊你，怎么你分享的接口文档这么多错误？后端：我吊你，你为什么没有测一测接口正不正常？前端：我为什么要测？你为什么不能确保你接口的正确性？后端：你为
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档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中接入正
