mall项目采用现阶主流技术实现,这些主流技术基本都升级了目前最新稳定版,具体升级内容大家可以参考下表。
技术版本说明
编辑切换为居中
添加图片注释,不超过 140 字(可选)
升级过程
升级过程中遇到一些问题,这里整理了下,给想要升级这套技术栈的小伙伴一个参考!
支持SpringBoot 2.7.0
看了下之前使用的2.3.0版本,一年前就End of Support了,升级2.7.0还是很有必要的。
编辑切换为居中
添加图片注释,不超过 140 字(可选)
升级2.7.0版本不仅是改个版本号就行了,由于SpringBoot2.6.x版本开始默认禁用了循环依赖,如果你的项目中循环依赖太多的话,只能使用如下配置开启了。
spring: main: allow-circular-references: true
既然官方都禁止使用了,我们还是从源头上解决循环依赖的好,如何优雅地解决循环依赖问题具体可以参考mall-tiny升级支持SpringBoot 2.7.0 中的解决循环依赖部分,mall项目也使用了这种优雅的方式。
Swagger改用Starter
之前项目中是直接使用Swagger依赖来集成的,并没有用Starter,这次改用了它。
在升级SpringBoot 2.6.x版本的时候,其实Swagger就有一定的兼容性问题,需要在配置中添加BeanPostProcessor这个Bean,具体可以参考升级 SpringBoot 2.6.x 版本后,Swagger 没法用了 。
SpringSecurity用法升级
在升级SpringBoot2.7.0版本后,SpringSecurity中有个重要的类被弃用了,那就是一直作为配置类使用的WebSecurityConfigurerAdapter。
编辑切换为居中
添加图片注释,不超过 140 字(可选)
新用法非常简单,无需再继承WebSecurityConfigurerAdapter,只需直接声明配置类,再配置一个生成SecurityFilterChainBean的方法,把原来的HttpSecurity配置移动到该方法中即可,mall项目也采用了这种新用法。
/** * SpringSecurity 5.4.x以上新用法配置 * 为避免循环依赖,仅用于配置HttpSecurity * Created by macro on 2022/5/19. */ @Configuration public class SecurityConfig { @Bean SecurityFilterChain filterChain(HttpSecurity httpSecurity) throws Exception { //省略HttpSecurity的配置 return httpSecurity.build(); } }
最新版Spring Security用法具体可以参考Spring Security 最新用法 。
MyBatis升级
在升级MyBatis的过程中,也升级了MySQL的驱动版本,从8.0.16升级到了8.0.29。
之前有小伙伴提出升级到该版本后,在Linux上无法连接到MySQL数据库,其实是因为默认使用了SSL连接导致的,在配置文件中添加useSSL=false配置即可解决。
spring: datasource: url: jdbc:mysql://db:3306/mall?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false username: reader password: 123456
ELK日志收集系统升级
其实每次升级SpringBoot版本,如果集成了Elasticsearch都基本要升级ES,然后整套ELK组件都得升级,这次全部升级到了7.17.3版本。
为什么升级该版本呢?因为SpringBoot2.7.0使用的Java SDK默认兼容该版本。
编辑切换为居中
添加图片注释,不超过 140 字(可选)
不得不说ES的Java SDK各版本兼容性很差,如果还是使用之前的7.6.2版本的话,运行mall-search中的单元测试代码会出现如下问题。很多小伙伴使用ES出现一些稀奇古怪的问题,大概率是版本兼容性问题。
编辑切换为居中
添加图片注释,不超过 140 字(可选)
看一眼升级后的日志收集系统,Kibana的界面更现代化了!
编辑切换为居中
添加图片注释,不超过 140 字(可选)
MongoDB升级
MongoDB升级5.0用法基本和之前一致,但是在部署到Docker环境时发现,MongoDB5.0居然需要特定CPU支持,只得改用4.x版本了。
编辑切换为居中
添加图片注释,不超过 140 字(可选)
镜像打包插件改用fabric8io
之前一直使用的是spotify出品的docker-maven-plugin,用于打包应用Docker镜像并上传到服务器。上了下官网,这个插件基本上是不维护了,之前也有小伙伴反馈使用有问题。
编辑切换为居中
添加图片注释,不超过 140 字(可选)
现在改用了fabric8出品的docker-maven-plugin,功能更强大,更新也比较及时。
编辑切换为居中
添加图片注释,不超过 140 字(可选)
虽然插件换了,但用法还是一样的,配置好docker远程访问地址后直接双击package命令就可以实现一键打包上传应用镜像了。
编辑切换为居中
添加图片注释,不超过 140 字(可选)
部署文档更新
项目的部署文档也同步更新了,具体可以参考以下链接。
mall在Windows环境下的部署
https://www.macrozheng.com/mall/deploy/mall_deploy_windows.html
mall在Linux环境下的部署(基于Docker容器)
https://www.macrozheng.com/mall/deploy/mall_deploy_docker.html
mall在Linux环境下的部署(基于Docker Compose)
https://www.macrozheng.com/mall/deploy/mall_deploy_docker_compose.html
总结
今天分享了一下mall项目的升级内容和升级过程中遇到的一些问题,不得不说,SpringBoot确实是个很棒的框架,跨了几个大版本升级到2.7.0,代码几乎无需改动。SpringBoot 2.7 版本很可能成为一个钉子户版本,因为从SpringBoot 3.0 开始最低要求Java 17了,大家可以尝试下升级到该版本!
项目源码地址
开源不易,觉得项目有帮助的小伙伴点个Star支持下吧!
https://github.com/macrozheng/mall