如何通过gateway聚合并统一管理swagger3的API文档？

本文共计1714个文字，预计阅读时间需要7分钟。

Spring Boot微服务整合Swagger3方法简单，下面会演示。但在分布式项目中，如果每个微服务都需要独立的API文档，那么就不太方便了。本文将详细讲解Spring Cloud Gateway如何聚合系统。

　　springboot微服务整合swagger3方法很简单，下文会演示。但是在分布式项目中如果每个微服务都需要单独的分开访问获取接口文档就不方便了，本文将详细讲解springcloud gateway网关如何聚合统一管理swagger接口文档。

先贴张整合后的效果图(通过切换左上角的下拉窗口获取每个微服务的接口文档)：

一、swagger简介

• 基于 OpenAPI 规范（OpenAPI Specification，OAS）构建的开源接口文档自动生成工具，可以让开发人员快速设计、构建、记录以及使用 Rest API。

• 目前的版本有swagger2.0和3.0，swagger2于17年停止维护，现在最新的版本为17年发布的 Swagger3（Open Api3）。

• Swagger 主要包含了以下三个部分：

• • 　　Swagger Editor：基于浏览器的编辑器，我们可以使用它编写我们 OpenAPI 规范。
  • 　　Swagger UI：它会将我们编写的 OpenAPI 规范呈现为交互式的 API 文档，后文我将使用浏览器来查看并且操作我们的 Rest API。