## 升级注意点，请务必确认

#### 一、nacos2.0升级注意点

1. 本次升级适配了Nacos2.0，支持长链接特性。2.0版本的兼容性介绍可以见：https://nacos.io/zh-cn/docs/2.0.0-compatibility.html

2. Nacos2.0升级适配的后端commit请见：https://git.bladex.vip/blade/BladeX-Tool/commit/720fa72f7ed8201edeb2319e8d42671afe7a8aab、https://git.bladex.vip/blade/BladeX/commit/1aa10bfac0a2ee69bc842162e07a15f243c24660

3. Nacos2.0版本相比1.X新增了gRPC的通信方式，需要增加2个端口。新增端口是在配置的主端口(server.port)基础上，进行一定偏移量自动生成。

   客户端拥有相同的计算逻辑，用户如同1.X的使用方式，配置主端口(默认8848)，通过相同的偏移量，计算对应gRPC端口(默认9848)。如果客户端和服务端之前存在端口转发，或防火墙时，需要对端口转发配置和防火墙配置做相应的调整。

   | 端口 | 与主端口的偏移量 | 描述                                                       |
   | ---- | ---------------- | ---------------------------------------------------------- |
   | 9848 | 1000             | 客户端gRPC请求服务端端口，用于客户端向服务端发起连接和请求 |
   | 9849 | 1001             | 服务端gRPC请求服务端端口，用于服务间同步等                 |

4. 若是docker启动，需要映射新端口并且服务器将其对外开放，启动命令如下：

   ~~~shell
   docker run --name nacos-standalone -e MODE=standalone -d -p 8848:8848 -p 9848:9848 -p 9849:9849 nacos/nacos-server:2.0.0
   ~~~

#### 二、关于Xss、Auth路径匹配注意点

1. 新版本采用了AntPathMatcher类进行url的匹配，支持正则表达式等特性，逻辑与之前略微有变动
2. 老版本若配置了 /test ，则会对 /test 以及 /test/** 都进行匹配
3. 新版本若配置了 /test ，则只对 /test 进行匹配
4. 若需要子方法都匹配并且之前只配置了固定方法如 /test ，大家需要将其改为 /test/**

#### 三、关于Saber新版本升级

1. 新版本升级avue至2.8.12，有些许改动，升级时请参考：https://git.bladex.vip/blade/Saber/commit/3a4d2ec6b199b7f8be0f02002f3466ea960c18e0
2. 新版本的字典管理模块重构了界面，升级时请参考：https://git.bladex.vip/blade/Saber/commit/6fdae97b95a8923d2c9dcba4ebd2ae2c65266fe0
3. 若需要以前版本的字典管理模块，请到 `/src/views/util/demo`目录下找到对应文件覆盖