mall-swarm 微服务电商项目打造 Spring Cloud 最佳实践

之前把我的mall项目更新到了SpringBoot 2.3.0版本，微服务版本mall-swarm也已同步更新了。此次更新完善了项目的Spring Cloud技术栈，升级至Spring Cloud Hoxton版本并加入了Spring Cloud Alibaba、Oauth2和Knife4j，致力于打造Spring Cloud 最佳实践项目！

一、系统架构图

二、项目组织架构

mall
├── mall-common -- 工具类及通用代码模块
├── mall-mbg -- MyBatisGenerator生成的数据库操作代码模块
├── mall-auth -- 基于Spring Security Oauth2的统一的认证中心
├── mall-gateway -- 基于Spring Cloud Gateway的微服务API网关服务
├── mall-monitor -- 基于Spring Boot Admin的微服务监控中心
├── mall-admin -- 后台管理系统服务
├── mall-search -- 基于Elasticsearch的商品搜索系统服务
├── mall-portal -- 移动端商城系统服务
├── mall-demo -- 微服务远程调用测试服务
└── config -- 配置中心存储的配置

三、更新内容一览

• 集成Spring Cloud Alibaba，注册中心改用Nacos；
• 权限功能改用Oauth2，实现统一认证和鉴权；
• 集成Knife4j，实现网关聚合API文档；
• 升级Spring Cloud Hoxton.SR5；
• 升级Spring Boot 2.3.0.RELEASE；
• 升级Elasticsearch 7.6.2；
• ELK日志收集功能完善，采用分场景收集日志的方式；
• Window和Linux部署文档更新。

四、更新内容介绍

Spring Cloud Alibaba

集成了Spring Cloud Alibaba，注册中心和配置中心都改用了Nacos。之前使用的注册中心是Eureka，已经进入维护期不再更新了，之前使用的配置中心是Spring Cloud Config，需要使用消息队列才能实现配置刷新。Nacos既可以当注册中心又可以当配置中心，采用Netty保持TCP长连接实现配置刷新，拥有方便的管理界面，所以就改为使用Nacos了。原来的mall-registry和mall-config模块已被移除，在config文件夹中存放了Nacos中的配置，启动项目时需要导入到Nacos中去。

Oauth2

• 之前项目中有个mall-security的模块，我把它称为安全模块。所有需要权限校验的模块都需要依赖它，有点工具包的感觉，在微服务中使用总感觉不伦不类。

• 这次改为使用Oauth2，添加了认证中心 mall-auth，实现统一认证和鉴权，更加符合微服务权限控制，具体可以参考《微服务权限终极解决方案，Spring Cloud Gateway + Oauth2 实现统一认证和鉴权！》。

• 由于项目中存在两套不同的用户体系，后台用户和前台用户，认证中心对多用户体系也有所支持，访问认证中心时使用不同的client_id和client_secret即可区分不同用户体系，后台用户使用admin-app:123456，前台用户使用portal-app:123456。

• 对原来的登录接口做了兼容处理，分别会从内部调用认证中心获取Token，依然可以使用。

Knife4j

之前每个微服务都有自己的API文档地址，需要单独访问。这次把所有微服务的API文档都聚合到了网关上，统一了访问入口，直接访问网关的API文档地址即可，具体可以参考《微服务聚合Swagger文档，这波操作是真的香！》。

Spring Cloud Hoxton.SR5

Spring Cloud 和SpringBoot有着版本对应关系，升级到SpringBoot 2.3.0正好对应了该版本。

为者常成，行者常至