不知道大家工作中有没有使用Swagger，可能没有用过，但是肯定或多或少的接触过、听说过，它是一款基于Restfull接口的文档在线生成 + 功能测试的工具。

这里大家可以关注一下我的个人专栏《Java 进阶集中营》，每天会给大家即时分享一个最新的java技术资讯，有优秀的java技术内容，也欢迎分享在我的专栏。JAVA 进阶集中营​zhuanlan.zhihu.com

网上有很多SpringBoot如何集成Swagger的教程，但是对于微服务而言，多个模块之前应该如何使用Swagger呢？总不能每个模块单独集成一个，

那么当有很多个模块的时候，是不是相应的也就产生了很多的地址，这样对我们来说确实不是一件非常友好的事情，那么有没有办法解决呢？

答案肯定是有的，那么我们直接进入主题，说说SpringCloud是如何集成Swagger的。

项目结构

这是我们的项目结构，分别是订单模块，会员模块，注册中心，网关。

其实我们就是通过网关去整合Swagger来管理微服务所有的API的。那么如何来实现呢？

分别在订单模块和会员模块中引入swagger的maven坐标，用过Swagger的朋友可能之前使用的是另外的两个maven坐标，其实SpringBoot内部已经帮我们封装了Swagger，跟另外的两个坐标的作用其实是一样的，所以我们只需要引入这个坐标即可。

com.spring4all

swagger-spring-boot-starter

1.7.0.RELEASE

接下来就是在订单模块和会员模块的启动类上加上开启Swagger的注解，让Swagger生效，如下图

在订单模块和会员模块的application.yml中配置接口的扫描范围

到这里我们订单模块和会员模块算是配置完了，最后我们来定义两个简单的接口进行测试，本文并没有讲述Swagger注解的使用，关于这部分内容，大家可以参考这篇文章

接下来就是重点了，配置网关，首先引入swagger的maven坐标，同样在启动类上开启Swagger，并且开启路由服务

首先我们先配置一下application.yml，通过访问网关将服务路由到具体的业务模块中去，shopping-member其实就是会员模块中配置文件配置的唯一标识，后面的/member/**,就是我们访问127.0.0.1:9000/member/

就是将服务路由到我们的会员模块，后面在拼接具体的路径就可以访问到我们的接口了

最后我们再写一个配置类，代码中的/member/v2/api-docs中的member其实就是我们上图中配置的member，至于前面的参数就是一个模块的名字，可以随意起没有什么规则

@Component

@Primary

public class SwaggerConfig implements SwaggerResourcesProvider {

@Override

public List get() {

List resources = new ArrayList<>();

/**

* shopping-member ---> 这个就是个模块的名字，可以随便起

* /member/v2/api-docs ---> member就是application.yml配置的路由路径，后面的/v2/api-docs固定写法

*/

resources.add(swaggerResource("shopping-member", "/member/v2/api-docs", "2.0"));

resources.add(swaggerResource("shopping-order", "/order/v2/api-docs", "2.0"));

return resources;

}

private Object swaggerResource(String name, String location, String version) {

SwaggerResource swaggerResource = new SwaggerResource();

swaggerResource.setName(name);

swaggerResource.setLocation(location);

swaggerResource.setSwaggerVersion(version);

return swaggerResource;

}

}

到这里我们SpringCloud多模块集成Swagger就算完成了，最后我们来启动下，看下效果。

那么这样我们就可以将我们的多个模块全部集成到这里了。