你应该知道的 Nacos 接入和避坑指南

良许 本文转载自微信公众号「Java极客技术」，做者鸭血粉丝 。转载本文请联系Java极客技术公众号。

Hello 你们好，我是阿粉，今天给你们分享微服务环境下必需要使用的一个强大的组件 Nacos。自从使用了 Nacos，阿粉的服务再也没有担忧过服务注册和发现以及配置管理混乱的问题了。

背景

Nacos 致力于帮助开发人员发现、配置和管理微服务，Nacos 提供了一组简单易用的特性集，快速实现动态服务发现、服务配置、服务元数据及流量管理。

目前主流的互联网服务都是基于微服务架构的，那服务与服务之间的交互是必不可少的，并且各个服务的上下线都是相互独立的，并且服务的配置信息也是会动态调整的，这就须要咱们的服务更加灵活。Nacos 的出现就是帮助咱们实现这些繁琐的功能。

详细的 Nacos 介绍和部署能够参考官方网站 Nacos.io。这里只介绍一下在 SpringBoot 项目中如何快速接入以及接入和使用过程当中可能会遇到的坑。

接入

加入依赖

第一步在 pom 配置文件中加入下面的依赖，用于实现服务注册发现和配置中心功能。

<!-- nacos 配置中心 --> 
<dependency> 
  <groupId>com.alibaba.cloud</groupId> 
  <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId> 
</dependency> 
<!-- nacos 注册发现 --> 
<dependency> 
  <groupId>com.alibaba.cloud</groupId> 
  <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId> 
</dependency>

增长配置

1.第二步在 SpringBoot 项目的启动类上增长以下注解 @EnableDiscoveryClient 用于启动服务注册发现功能。

2.增长配置文件，对应的配置信息须要修改为适合本身的，为了方便管理，应用的分组名称，命名空间以及相关的配置都须要合理的设置。多个业务使用同一个 nacos 集群的时候，须要根据各个的业务设定各自的命名空间。全部的配置文件都须要在对应的命名空间下设置，避免多个业务混用，另外业务须要根据用到的组件或者配置，设定独立的配置文件，例如数据库的配置，Redis 的配置等都须要单独设定，这样是为了同一个应用其余的其余服务也可使用，并且再有地址变动的时候能够只修改一个文件就好，不会忘记。

# 应用服务名称 
spring.application.name=application-name 
# 应用分组名称 
spring.cloud.nacos.config.group=GROUP-NAME 
# 配置文件的后缀名 
spring.cloud.nacos.config.file-extension=properties 
# nacos 对应的命名空间，在后台建立好命名空间后会自动生成 
spring.cloud.nacos.config.namespace=xxxxxxxxxxxxxxxxxxxxxxxxx 
# 对应的配置文件 
# MySQL 相关配置 
spring.cloud.nacos.config.ext-config[0].data-id=mysql.properties 
spring.cloud.nacos.config.ext-config[0].group=GROUP-NAME 
# Redis 相关配置 
spring.cloud.nacos.config.ext-config[1].data-id=redis.properties 
spring.cloud.nacos.config.ext-config[1].group=GROUP-NAME 
# 其余配置等 
spring.cloud.nacos.config.ext-config[2].data-id=other.properties 
spring.cloud.nacos.config.ext-config[2].group=GROUP-NAME 
# 配置中心地址，多个逗号分隔 
spring.cloud.nacos.config.server-addr=xxx.xx.xx.xx:xxxx 
# 服务注册发现地址，多个逗号分隔 
spring.cloud.nacos.discovery.server-addr=xxx.xx.xx.xx:xxxx 
# 集群名称 
spring.cloud.nacos.discovery.cluster-name=CLUSTER-NAME

3.代码中可使用注解 @Value() 来直接读取 Nacos 配置中的属性参数，也可使用 @ConfigurationProperties(prefix = "spring.datasource") 读取批量参数。

4.spring.cloud.nacos.config.ext-config[0].refresh=true 该参数表示是否开启自动更新，根据是否须要自动更新以为是否配置，若是须要自动更新，加上这个配置后还须要在须要自动更新配置的 Bean 上面增长@RefreshScop 注解。而后对应的 Bean 内部的属性就能够实现自动更新了。增长了spring.cloud.nacos.config.ext-config[0].refresh=true 配置后在修改了 Nacos 中的配置事后日志会出现下面信息，会从新加载配置，而且输出变动的 key 信息。

5.

服务调用

当全部的服务都接入 Nacos 事后，咱们在 Nacos 的后台就能够看到每一个服务的状况，以下图，能够看到服务状态。

而后咱们在服务 A 里面若是要调用服务 B 的时候，就能够直接在 FeginClient 中配置服务 B 的名称，不须要填写 URL 了。这样咱们就不用考虑服务 B 是否地址和端口会不会变。服务 B 的实例增长仍是减小，端口是否变了，对服务 A 来讲都不关心，只要有个服务名称就能够了。

避坑

命名空间

Nacos 有一个默认的名为 public 的命名空间，这个命名空间是没法删除的，全部未指定命名空间的配置都会放在该命名空间下;一样的 Nacos 有一个默认的名为 DEFAULT_GROUP 的分组，在没有指定分组名称的时候默认的配置都是在该分组下。

对于咱们应用程序来讲，因为不少状况下一个 Nacos 集群是多个团队共同使用的，因此为了方便管理，咱们须要根据本身的业务设置本身的命名空间，用于存放本业务的配置文件。本命名空间下的配置文件，根据各个的模块决定是否须要从新分组。

要知道在没有清晰的命名空间划分的时候，要想修改一个配置的内容，是很难受的一件事情。线上的配置调整，一个不当心就是事故。若是仍是自动更新配置的话，那连后悔的机会都没有。

精细配置

配置文件应该专注，一个配置文件就设置一个内容，好比 MySQL 的数据源单独一个配置，Redis 的数据源单独一个配置，若是多个 Redis 服务，根据功能建议分开配置，由于并非全部的服务都须要每一个 Redis 的连接配置。各自的服务根据须要单独引用对应的配置文件便可。

将全部的配置独立成一个配置文件方便后续修改配置，只要修改一个配置文件就好，不用担忧其余还有未修改的地方。

合理的规划配置文件的内容，每每不少时候能够事半功倍，极大的节约时间和减小出错的几率。

自动刷新

前面介绍了如何设置配置自动刷新，不过服务是否须要自动更新配置，这个根据自身的业务去决定。

我这里通常不建议设置自动更新，由于如今都是微服务部署，有时候咱们上线一个新功能的时候都是灰度发布，若是配置自动更新，再调整配置事后，所有实例都会生效，这样会有风险。不设置自动更新的话，咱们能够单独重启个别实例，观察线上状况，等稳定了再发布全部服务，这样会安全不少。

固然对于没有那么多服务，不须要灰度，影响不大的场景下，配置自动更新会方便不少，再修改配置后不须要重启服务。

总结

Nacos 做为服务的注册发现和配置的统一管理确实十分出色，除了能快速接入 SpringBoot 项目以外，其余的框架都能快速的接入，更多使用能够参考官网。

最后但愿你们都能解放双手快速接入玩起来!

写在最后

最后邀请你加入咱们的知识星球，这里有 1800+ 优秀的人与你一块儿进步，若是你是小白那你是稳赚了，不少业内经验和干货分享给你;若是你是大佬，那能够进来咱们一块儿交流分享你的经验，说不定往后咱们还能够有合做，给你的人生多一个可能。

【编辑推荐】

1. 为何选用Nacos？虎牙直播微服务改造实践
2. ZooKeeper、Eureka、Consul 、Nacos微服务注册中心对比
3. 微服务，Java目前很火热的系统架构
4. 用容器与微服务安全来加持DevSecOps
5. 十年架构师耗尽心血带你如何进行微服务的单元、集成和系统测试？

【责任编辑：武晓燕 TEL：（010）68476606】