項目更新日志 · 企業級微服務框架項目技術文檔

[TOC] ## V6.0.0 更新說明：https://mp.weixin.qq.com/s/CJ7sk-FmT5tPQy3rS7SPwg - 授權服務升級為 `Spring Authorization Server` - 升級到 `jdk17` - 升級 `Swagger` 為 `OpenAPI3` - 升級 `spring-boot` 到 `3.1.6` - 升級 `spring-cloud` 到 `2022.0.4` - 升級 `spring-cloud-alibaba` 到 `2022.0.0.0` - 升級 `spring-boot-admin` 到 `3.1.8` - 升級 `mybatis-plus` 到 `3.5.4.1` - 刪除txlcn-demo工程(由于txlcn不推薦使用了) - 刪除無用模塊(job和transaction)   ## V5.6.0 更新說明：https://mp.weixin.qq.com/s/sBApgaqW4VYBeeFxaqnHXw - 新增 `數據權限` 支持 - 認證中心授權接口支持 `參數加密` - 密碼加密支持 `國密SM3`   ## V5.5.0 更新說明：https://mp.weixin.qq.com/s/gmdmxgXlaDYR33doXgK6_A - 新增 `react` 前端工程(Ant Design Pro) - 修復 `oidc-sso` 樣例工程的數據問題 - 升級 `spring-cloud` 到 `2020.0.6`   ## V5.4.0 更新說明：https://mp.weixin.qq.com/s/_txF7tAoHHjItbb0sKjPWA - 支持 `webSocket` 鑒權 - 增加 `webSocket` 鑒權樣例工程 - 支持手動 **獲取當前登錄人** 對象 - 增加手動 **token鑒權** 工具 - 增加 **資源服務** 樣例工程 - 解決只要請求攜帶 `access_token`，排除鑒權的 `url` 依然會被攔截的問題 - 升級 `spring-boot` 到 `2.5.14`   ## V5.3.0 更新說明：https://mp.weixin.qq.com/s/-yn1UtIETIJAjDft7-Tzrw - 自定義負載均衡 - 優化授權中心 `redis-token` 內存占用 - 適配 `mybatis-plus` 攔截器新配置方式 - 升級 `spring-boot` 到 `2.5.13` - 升級 `spring-cloud` 到 `2020.0.5` - 升級 `spring-boot-admin` 到 `2.5.6` - 升級 `mybatis-plus` 到 `3.5.1`   ## V5.2.0 更新說明：https://mp.weixin.qq.com/s/eyrBQBK2JEyKrFQ0ypa-yA - 日志鏈路 `spanId` 生成規則優化 - 增加日志鏈路頁面 - 增強授權中心UAA可配置功能 - 提高nacos日志打印級別 - 升級 `spring-boot` 到 `2.5.9 ` - 升級 `spring-boot-admin` 到 `2.5.5 ` - 升級 `hutool` 到 `5.7.20`   ## V5.1.0 更新說明：https://mp.weixin.qq.com/s/0F1Rl_eeKrC2FM_BhHXp4Q - 認證中心支持 **單點登出** - sso-demo增加單點登出支持 - 日志鏈路追蹤增加 `spanId` 和 `parentId ` - 升級 `spring-boot` 到 `2.5.7 ` - 升級 `spring-cloud` 到 `2020.0.4 ` - 解決客戶端模式授權報錯問題   ## V5.0.0 更新說明：https://mp.weixin.qq.com/s/DhFKRqIRV9RNPJBzZQVXsg - 升級 `spring-boot` 到 `2.5.4 ` - 升級 `spring-cloud` 到 `2020.0.3 ` - 升級 `spring-cloud-alibaba` 到 `2021.1 ` - 升級 `druid-spring-boot-starter` 到 `1.2.6 ` - 升級 `elasticsearch` 到 `7.14.0 ` - 升級 `spring-boot-admin` 到 `2.5.1 ` - 新增 `zlt-loadbalancer-spring-boot-starter` 工程 - 增加分支 `4.x`（該分支不會更新） - Spring Boot 2.3.12.RELEASE - Spring Cloud Hoxton.SR12 - Spring Cloud Alibaba 2.2.6.RELEASE - 移除 `zlt-ribbon-spring-boot-starter` 工程 - 移除 `zuul-gateway` 工程   ## V4.6.0 更新說明：https://mp.weixin.qq.com/s/3Swliseduw9mihou9qG_aA * 授權中心支持 **多用戶體系** 擴展 * 升級 `spring-boot` 到 `2.3.12.RELEASE` * 升級 `spring-cloud` 到 `Hoxton.SR12` * 升級 `spring-cloud-alibaba` 到 `2.2.6.RELEASE` * 升級 `redisson` 到 `3.16.0` * 升級 `spring-data-elasticsearch` 到 `4.2.3` * 升級 `transmittable` 到 `2.12.1`   ## V4.5.0 更新說明：https://mp.weixin.qq.com/s/7g3Ab19m-Sjlw1ADD5X5dw * 支持 **OIDC協議** 授權 * 應用管理界面增加 **ID令牌** 相關的配置 * 增加oidc協議單點登錄樣例工程 `oidc-sso ` * 增加zookeeper工具類 `zookeeperTemplate ` * 替換默認PasswordEncoder實現類為 `DelegatingPasswordEncoder ` * 修改文件中心默認依賴為 `s3 ` * 升級 `spring-boot` 到 `2.3.11.RELEASE ` * 修復token過期時訪問網關返回500狀態碼   ## V4.4.0 更新說明：https://mp.weixin.qq.com/s/gXCdCv-3jBG2PWmMwXkPAw * 新增工程 `zlt-oss-spring-boot-starter ` * 新增工程 `zlt-zookeeper-spring-boot-starter ` * 新增 `Zookeeper` 分布式鎖 * 優化 `日志埋點` 工具類 * 升級 `zlt-register/nacos` 到 `2.0.0`   ## V4.3.0 更新說明：https://mp.weixin.qq.com/s/TgE6ZZ3YkolbkrK1--eT_A * 登錄同應用**同賬號互踢** * 增加**Dubbo集成**樣例 `dubbo-demo` * 優化**日志鏈路追蹤**代碼 * 優化 `oauth2` 授權錯誤處理 * 升級 `zlt-register/nacos` 到 `1.4.1` * 升級 `spring-boot` 到 `2.3.8.RELEASE` * 升級 `spring-cloud` 到 `Hoxton.SR9` * 升級 `spring-cloud-alibaba` 到 `2.2.5.RELEASE` * 升級 `spring-boot-admin` 到 `2.3.1.RELEASE` * 升級 `redisson` 到 `3.14.1` * 升級 `transmittable` 到 `2.12.0` * 升級 `elasticsearch` 到 `7.10.2` * 升級 `spring-data-elasticsearch` 到 `4.1.3`   ## V4.2.0 更新說明：https://mp.weixin.qq.com/s/752ARPQ9cJWQQQtNbrT9Tg * 新增 `jackson` 工具類 * **json**相關代碼替換 `fastjson` 為 `jackson` * 升級 `spring-boot` 到 `2.2.10.RELEASE` * 升級 `spring-cloud` 到 `Hoxton.SR8` * 升級 `spring-cloud-alibaba` 到 `2.2.3.RELEASE` * 升級 `mybatis-plus-boot-starter` 到 `3.4.0` * 升級 `spring-data-elasticsearch` 到 `3.2.10.RELEASE` * 升級 `knife4j` 到 `2.0.5` * 修復redis的increment命令的反序列化問題   ## V4.1.0 更新說明：https://mp.weixin.qq.com/s/g9WdP-OKfTXiJPYlG1xCxg * 優化 `分布式鎖` 增加**自動解鎖**功能 * 優化 `swagger-ui` 替換為 `knife4j` * 更新 `seata-demo` 的代碼適配 `seata1.3` * 完善 `web-sso` 單點登錄demo添加 `state參數` 驗證，防止**CSRF攻擊** * 升級 `spring-boot` 到 `2.2.8.RELEASE` * 升級 `spring-cloud` 到 `Hoxton.SR7` * 升級 `spring-boot-admin` 到 `2.2.4.RELEASE` * 修復改為jwt token類型無效的問題 * 優化sc-gateway的異常處理返回狀態碼   ## V4.0.0 更新說明：https://mp.weixin.qq.com/s/VkfEKwB97BYR66rvLs5NaQ * 重構uaa的自定義授權實現，統一授權接口使用 `grant_type` 區分 * 基礎框架版本升級 * 升級 `spring-boot` 到 `2.2.8.RELEASE` * 升級 `spring-cloud` 到 `Hoxton.SR6` * 升級 `spring-cloud-alibaba` 到 `2.2.1.RELEASE` * 升級 `spring-boot-admin-starter-server` 到 `2.2.3` * 升級 `search-center` 支持**ES7.x**版本，**不支持6.x**版本 * 升級 `elasticsearch-rest-high-level-client` 到 `7.8.0` * 升級 `elasticsearch-rest-client` 到 `7.8.0` * 升級 `elasticsearch` 到7.8.0` * 升級 `zlt-register/nacos` 到 `1.3.1` * 升級 `transmittable-thread-local` 到 `2.11.5` * 修復用戶列表只顯示用戶所關聯的當前租戶的角色 * 修復redis-cluster模式下有時候會刪除token失敗 * [#I1LPAV] RedisClientDetailsService.removeRedisCache()方法沒有刪除緩存 * [#I1KAME] SysRole類里的userId缺少@TableField(exist = false) * 增加分支 3.x（該分支不會更新） * Spring Boot 2.1.14.RELEASE * Spring Cloud Greenwich.SR6 * Spring Cloud Alibaba 2.1.2.RELEASE   ## V3.7.0 更新說明：https://mp.weixin.qq.com/s/ifL3Jj2g6_qM-BEHeFo_Kg * 分布式鎖增加注解調用方式 * 優化應用管理編輯頁面和列表 * 優化授權碼模式的登錄錯誤響應 * 優化登出邏輯 * 升級 `zlt-register/nacos` 到 `1.3.0` * 升級 `spring-boot` 到 `2.1.14.RELEASE` * 升級 `spring-cloud` 到 `Greenwich.SR6` * 升級 `fastjson` 到 `1.2.70` * 升級 `druid-spring-boot-starter` 到 `1.1.22` * 升級 `fastdfs-client` 到 `1.27.2` * 升級 `spring-data-elasticsearch` 到 `3.2.7.RELEASE` * 升級 `commons-configuration2` 到 `2.7` * 修復開啟多租戶時不同的租戶使用授權碼模式單點登錄時角色沒有變更的問題 * 修復token失效時網關會出現跨域問題   ## V3.6.1 * 修復`saveIdempotency`方法釋放鎖時的傳參錯誤 * 去掉`getLoginAppUser`方法加鎖的測試代碼，導致登錄后刷新頁面假死   ## V3.6.0 更新說明：https://mp.weixin.qq.com/s/XzOyP2KhW8iw-Z8_cvcBJA * 分布式鎖的實現方式改為 `Redisson` 并優化抽象接口 * 修改zlt-redis-spring-boot-starter的客戶端由 `lettuce` 改為 `redisson`，同時兼容 `RedisTemplate` 和 `RedissonClient` 兩種客戶端API * 修改DefaultWebMvcConfig類由WebMvcConfigurationSupport改為WebMvcConfigurer，避免覆蓋其他的WebMvc配置 * 支持 `Nacos 1.2` 服務注冊發現認證配置 * 升級 `spring-cloud-alibaba-dependencies` 到 `2.1.2.RELEASE` * 升級 `elasticsearch-rest-high-level-client` 到 `6.8.8` * 升級 `elasticsearch-rest-client` 到 `6.8.8` * 升級 `elasticsearch` 到 `6.8.8`   ## V3.5.0 更新說明：https://mp.weixin.qq.com/s/0e3NWyFNbmVC-BsS33b6nw * 新增`zlt-elasticsearch-spring-boot-starter`工程 * 支持`xpack`安全認證 * 支持最新的`es7.x`版本 * 支持自定義`連接池`參數 * 優化搜索中心`search-center`客戶端由`TransportClient`改為`HighLevelClient ` * 優化公共`starter`的bean加載方式，避免依賴的工程因包路徑不一致而導致加載不了的情況 * 優化`zlt-uaa`的bean加載方式 * 優化`zlt-uaa`原生的授權接口返回統一的json格式 * 優化`zlt-db-spring-boot-starter`自動裝配`MybatisPlus`配置，去掉`DefaultMybatisPlusConfig`類 * 修復開啟多租戶時`zlt-uaa`原生的授權接口和refresh_token接口丟失租戶id導致角色取不到的問題   ## V3.4.0 更新說明：https://mp.weixin.qq.com/s/hO3ZgSyHRnZ6MPFqwFtLvw * 首頁增加**天流量趨勢圖**，并優化圖表樣式 * 增加**前后端分離**的單點登錄樣例工程 `web-sso ` * 基于security實現的sso-demo增加**登出**功能 * 優化授權中心UAA的登出接口，支持自定義回調地址 * 優化back-web前端工程的登出邏輯 * 優化數據源配置添加時區參數 * 升級 `zlt-register/nacos` 到 `1.2.0`   ## V3.3.0 更新說明：https://mp.weixin.qq.com/s/BPwDUFLNtwsMT29o2E4rEw * 審計日志增加插入數據庫實現類，配置動態切換logger和db模式 * 增加基于oauth2的sso單點登錄樣例工程sso-demo * 升級 `hutool-all` 到 `5.1.4 ` * 升級 `lettuce-core` 到 `5.2.2.RELEASE`   ## V3.2.0 更新說明：https://mp.weixin.qq.com/s/n8VNlc_lZJcerONdQ4x9dg * 新增審計日志記錄功能(支持 `spEL` 表達式) * 新增審計日志頁面 * 修復開啟多租戶功能后，用戶管理中用戶只能分配webApp的角色 * 修復開啟url權限時，無權限訪問的api前端會報跨域錯誤 * 升級 `spring-boot` 到 `2.1.12.RELEASE ` * 升級 `spring-cloud` 到 `Greenwich.SR5 ` * 升級 `fastjson` 到 `1.2.62 ` * 升級 `druid-spring-boot-starter` 到 `1.1.21 ` * 升級 `hutool-all` 到 `5.1.2 ` * 升級 `mybatis-plus-boot-starter` 到 `3.3.1 ` * 升級 `poi` 到 `4.1.1 ` * 升級 `lettuce-core` 到 `5.2.1.RELEASE`   ## V3.1.0 更新說明：https://mp.weixin.qq.com/s/KNCn6qKecJkEuG-489_zAw * 拆分 `feign` 攔截器適配 `webflux` * 新增 `zlt-config/bootstrap.properties` 文件，用于 `bootstrap` 級別通用配置 * 簡化 `nacos` 的 `server-addr` 配置 * 遷移所有的 `nacos` 相關配置到 `zlt-config/bootstrap.properties` 文件下統一配置 * 優化網關認證信息傳遞邏輯，修復 `oauth2` 的 `客戶端模式` 認證時報錯的問題 * 修復 `sc-gateway` 開啟 `url` 權限時租戶的傳遞問題 * 升級 `spring-boot` 到 `2.1.9.RELEASE` * 升級 `spring-cloud-alibaba` 到 `2.1.1.RELEASE` * 升級 `zlt-register/nacos` 到 `1.1.4` * 升級 `mybatis-plus` 到 `3.2.0` * 升級 `spring-boot-admin-starter-server` 到 `2.1.6` * 升級 `hutool-all` 到 `5.0.5`   ## V3.0.0 * 增加 `Spring Cloud Gateway` 網關(sc-gateway模塊) * 集成 `Spring Security` 統一認證 * url權限控制 * swagger-api聚合 * 動態路由 * 版本號隔離策略 * 升級 `Spring Boot` 到 `2.1.8.RELEASE` * 升級 `Spring Cloud` 到 `Greenwich.SR3` * 升級 `Spring Cloud Alibaba` 到 `2.1.0.RELEASE` * 優化部分公共模塊適配 `webFlux` * 增加分支 `2.x` * 該分支只修復問題不增加新功能 * Spring Boot 2.0.9 * Spring Cloud Finchley.SR4   ## V2.7.2 * 優化代碼生成器代碼 * 修復開啟動態路由后網關聚合的`SWAGGER-API`有重復   ## V2.7.1 * 修復`租戶id`判斷邏輯問題 * 去掉無用的配置 * 修改`文件id`的生成規則為`uuid`，修復同一個文件id相同的問題   ## V2.7.0 * 新增分布式事務 `seata-demo` 演示工程 * 增加自定義負載均衡規則，實現服務實例版本號隔離 * 優化 **租戶**、**trace** 等數據傳遞方式，由攔截器改為過濾器 * 優化請求IP獲取 * 修復開啟url權限認證時認證方法的租戶id獲取不到的問題 * 升級驗證碼 `easy-captcha` 包到 `1.6.2 ` * 升級 `fastjson` 到 `1.2.60 ` * 升級 `swagger-butler` 到 `2.0.0`   ## V2.6.0 * zuul網關增加`動態路由`實現 * 增加分`布式日志鏈路追蹤 ` * 擴展線程池，父線程能傳遞`租戶`和`MDC`信息給子線程 * 文件日志`logger`改為異步方式 * Spring Boot自定義配置支持IDE自動提示 * 增加自定義`banner ` * 升級`lettuce`到`5.1.8.RELEASE`   ## V2.5.0 * **后端** * 增加多租戶功能(應用隔離) * 優化圖像驗證碼，改為gif動圖 * 增強`jwtToken`額外添加用戶`id`參數，@LoginUser注解能獲取(id、username 和roles)三個屬性 * 優化`Feign`攔截器，增加`access_token`、`userid`、`username`、`roles`、`client`等參數傳遞 * 優化部分接口返回前端的`json`格式改為標準格式 * 解決`poi`包沖突問題導致導入報錯，并優化導出為`xlsx`格式 * 升級`easypoi`到`4.1.0 ` * 升級`zlt-register/nacos`到`1.1.3 ` * **前端** * 角色管理、菜單管理、token管理增加`所屬應用`選擇 * 應用管理增加`應用名稱`字段   ## V2.3.0 * 優化url權限，并增加用戶管理的前后端結合樣例(按鈕/資源權限+后臺api權限) * api網關集成`Sentinel`網關流控組件 * 新增`jwt`和`rsa`工具類 * 優化授權認證配置，授權服務器關閉basic認證 * 優化多記錄insert改為batch批量方式 * 升級`spring-cloud-alibaba`到`2.0.0.RELEASE` * 升級`spring-cloud`到`Finchley.SR4` * 升級`mybatis-plus`到`3.1.2`   ## V2.2.0 * 優化認證配置 * 優化`redis token`模式，提升性能 * 增加`token`自動續簽功能（僅限于`redis token`模式），可配置化（開關、白名單、黑名單） * 增加`Token管理`模塊（僅限于`redis token`模式）："認證管理-token管理" * redis客戶端使用`lettuce`代替`jedis ` * 項目默認token模式改為`redis`，并且開啟自動續簽功能 * 升級`zlt-register/nacos`到`1.1.0`   ## V2.1.0 * 首頁增加`在線人數`統計 * 升級`zlt-register/nacos`到`1.0.1` * 優化`文件中心`列表的字段名 * 優化`統一異常處理`的注解   ## V2.0.0 * 新增`search-center`工程（搜索中心） * `search-server`為搜索中心服務端 * `search-client`為搜索中心客戶端（需要搜索的業務服務依賴該工程） * 前端頁面 * 新增`搜索中心-索引管理`和`搜索中心-用戶搜索`兩個功能 * 首頁增加訪問流量統計 * 用戶中心`user-center`集成`搜索中心`實現用戶全文搜索（需要搭配實時同步中間件，總體架構可參考：[實時搜索系統設計](http://www.hmoore.net/zlt2000/microservices-platform/1050047)） * 優化`log-center`去掉原來的es相關配置和代碼，改為集成`搜索中心` * 網關`zuul-gateway`增加請求埋點 * 升級`mybatis-plus`到`3.1.1`   ## V1.6.0 * 新增`rocketmq-demo`演示工程 * 集成`Spring-Cloud-Stream`消息框架(rocketmq-consume和rocketmq-produce) * MQ實現的分布式事務案例(rocketmq-transactional) * 重構`file-center`的自動化配置，并增加`FastDFS`的實現 * 升級`spring-cloud-alibaba`到`0.2.2.RELEASE` * 升級`spring-boot`到`2.0.9.RELEASE` * 升級`zlt-register/nacos`到`1.0.0 GA`   ## V1.5.0 * 新增sharding-jdbc-demo分庫分表演示工程(sharding-sphere3.1.0) * 升級Spring Cloud版本為`Finchley.SR3` * 獲取當前登錄人接口由`api-uaa/oauth/userinfo`替換為`api-user/users/current` * 刪除spring-cloud-gateway工程，因為目前該工程還不能完全集成進項目去等集成完畢再放出來 * 修復docker鏡像運行問題 * 優化redis配置，因為redis不同的集群部署配置完全不一樣，所以統一放到zlt-config中統一管理各環境的redis配置 * zuul 配置優化   ## V1.4.0 * 新增zlt-demo工程 * 新增zlt-transaction工程，集成分布式事務TX-LCN，支持LCN、TCC、TXC三種模式 * 升級spring-security-oauth2到`2.3.5.RELEASE` * 修復redis類型的token時，登出時的清理問題 * 添加feign攔截器，適配無網絡隔離時token的傳遞   ## V1.3.0 * 升級nacos為0.9.0 * prometheus支持，通過在`/prometheus`端點上暴露監控指標   ## V1.2.0 * 增加docker支持，通過`mvn docker:build`命令構建鏡像(免Dockerfile文件)   ## V1.1.3 * 優化sonar靜態代碼檢查的問題 * 增加項目發布jar到maven私服的配置 * 配置中心全局公共配置增加自動刷新功能   ## V1.1.0 * 前端和后端都支持多環境動態切換(為了CI/CD自動化部署) * 增加單元測試mock例子(為了CI/CD自動化測試) * 修復nacos配置中心失效問題 * 修復token失效時間無效問題 * 修復導出問題 * 優化log查詢，改為模糊查詢 * 優化sentinel配置