为了开启nacos的授权认证,需要将项目中的nacos升级到支持的版本
- spring boot:2.3.2.RELEASE
- spring cloud: Hoxton.SR9
- alibaba cloud: 2.2.6.RELEASE
版本之间的关系参考:
版本说明
测试中发现,2.1.1.RELEASE版本的cloud会报未知用户的异常,2.2.1则没有,能够正常使用nacos的授权认证,只测试了这两个版本,最后为了版本对应上,使用了nacos建议的2.2.6版本:
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
<version>2.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
<version>2.2.6.RELEASE</version>
</dependency>
nacos开启授权:
- 在nacos的安装目录下,编辑conf\application.properties,设置nacos.core.auth.enabled为true
- nacos中添加新用户及角色权限,注意:
2.1.开启认证授权后注册服务使用的用户需要有读写权限。
2.2.用户只有读权限,启动不成功,未知用户错误。
2.3.用户只有写权限,启动成功,但是有报错。 - 修改配置文件,支持认证:
3.1 增加用户名。密码配置:
3.2 升级过时配置:ext-config 变成了 extension-configs
spring:
cloud:
nacos:
## 用户名密码可以统一配置,也可以在discovery和config下单独配置
username: admin
password: 123456
discovery:
serverAddr: 127.0.0.1:8848
namespace: 8b77bb8b-180d-4ba2-b724-ba856ac396a2
config:
serverAddr: 127.0.0.1:8848
namespace: 8b77bb8b-180d-4ba2-b724-ba856ac396a2
extension-configs[0]:
data-id: redis.yaml
group: test
refresh: true
另外升级后项目中对于配置参数的默认值的处理发生了变化,不用在增加默认‘’,直接:即可
//原来处理默认值
@Value("${param:''}")
//升级后
@Value("${param:}")
如果升级后没有调整对默认值的处理,还是用原来的方式,那么参数获取值时将变成两个单引号字符串,而不再是空字符串
总结下升级中可能会出现异常的情况:
- 升级的版本是否支持
- 服务端nacos新增的用户角色权限是否是读写
- 检查是否同步更新了项目配置