笙亿网络策划

Spring Cloud 项目中用 Nacos 替代 Zookeeper 做注册中心优缺点对比

约 7 分钟读完 39 阅
文章导读
对于新建 Spring Cloud 微服务架构，尤其是国内团队，优先推荐选用 Nacos 作为注册中心；若现有 Zookeeper 集群运行稳定且无配置中心需求，不必强行迁移。
📋 目录
  1. 一 核心架构差异对比
  2. 二 迁移前置评估
  3. 三 实操迁移步骤
  4. 四 验证方法
  5. 五 常见坑与排查
  6. 六 参考来源
A A

对于新建 Spring Cloud 微服务架构，尤其是国内团队，优先推荐选用 Nacos 作为注册中心；若现有 Zookeeper 集群运行稳定且无配置中心需求，不必强行迁移。

先说结论：Nacos 在功能集成度和运维友好性上更适合现代 Spring Cloud 体系，但迁移需评估客户端兼容性与网络策略。

  • 适合：新建项目、需要注册发现与配置管理一体化、希望有可视化界面的团队。
  • 重点看：Nacos 的 AP/CP 模式切换能力与 Zookeeper 强一致性模型的差异。
  • 别忽略：迁移过程中的客户端依赖冲突、网络端口开放及数据一致性验证。

核心架构差异对比

Zookeeper 是 Apache 旗下的分布式协调服务，核心设计目标是强一致性（CP 模型），适合对数据一致性要求极高的场景，但运维门槛相对较高，且通常需配合 Spring Cloud Config 或其他方案实现配置管理。

Nacos 是阿里巴巴开源的动态服务发现、配置管理和服务管理平台。它在 Spring Cloud Alibaba 体系中原生集成，支持 AP 和 CP 模式切换。Nacos 的优势在于将注册中心与配置中心合二为一，减少了组件维护成本，且提供可视化管理界面，便于排查问题。

迁移前置评估

这不是一个命令能解决的变更，建议按以下思路评估：

  1. 确认 Zookeeper 用途：确认当前 Zookeeper 是否仅用于注册中心。若业务代码直接依赖 Curator 客户端实现分布式锁，仅移除 discovery 依赖会导致锁功能异常，需单独保留 Curator 依赖或迁移锁方案。
  2. 版本兼容性检查：检查 Spring Cloud 版本与 Spring Cloud Alibaba 版本的对应关系。Spring Cloud 2020.0.0+ 版本默认不再支持 bootstrap.yml，需额外处理。
  3. 灰度策略：在测试环境搭建 Nacos 集群，先行灰度接入部分非核心服务。

实操迁移步骤

若决定迁移，请按以下步骤操作，每一步都需确认无误后再继续：

Spring Cloud 项目中用 Nacos 替代 Zookeeper 做注册中心优缺点对比

1. 依赖调整
移除原有的 Zookeeper 发现依赖，引入 Nacos 发现依赖。注意 Spring Cloud 版本兼容性。

<!-- 移除 -->
<!-- spring-cloud-starter-zookeeper-discovery -->

<!-- 引入 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

<!-- 注意：若使用 Spring Cloud 2020.0.0+ 版本，需额外引入 bootstrap 依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

2. 配置文件修改
在application.yml中修改注册中心地址（若使用 Spring Cloud 2020.0.0+ 版本且未引入 bootstrap 依赖，配置需写在 application.yml 中；建议引入 bootstrap 依赖以保持配置结构一致）。

spring:
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
        namespace: your-namespace-id
        # 若需强一致性，可配置 cluster-name 或调整心跳策略

3. 网络策略检查
确保应用服务器能访问 Nacos 服务器的 8848 端口（HTTP）和 9848/9849 端口（gRPC，Nacos 2.x 版本客户端必需）。若防火墙只开放了 8848，会导致连接失败或频繁重连。

4. 回滚方案
保留旧版 Zookeeper 依赖配置在代码分支中，一旦新注册中心出现异常，立即切换回旧配置并重启服务。

验证方法

完成配置后，通过以下方式确认服务已正确注册：

  1. 控制台检查：登录 Nacos 控制台，在“服务管理”列表查看是否有新服务上线，状态是否健康。
  2. 接口调用：使用curl命令访问 Nacos 开放 API 查询服务实例。
    3. curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=YOUR_SERVICE_NAME&namespaceId=YOUR_NAMESPACE_ID'
  3. 日志观察：查看应用启动日志，确认没有注册中心连接报错，且打印了 Nacos 相关的初始化信息。
  4. 功能测试：验证服务间调用（Feign/RestTemplate）是否正常，配置变更是否能实时刷新（若同时迁移了配置中心）。

常见坑与排查

  • 版本不匹配：Spring Cloud Alibaba 与 Spring Cloud 版本有严格对应关系，随意升级可能导致启动失败。参考官方版本对照表。
  • CP/AP 模式误用：Nacos 默认是 AP 模式，若业务强依赖强一致性（如金融交易状态），需手动调整为 CP 模式，但这会影响可用性。
  • gRPC 端口阻断：Nacos 2.x 客户端默认使用 gRPC 通信，偏移端口为 9848/9849，需确保网络通畅。
  • 临时实例与持久实例：理解 Nacos 中临时实例（心跳丢失即剔除）与持久实例（需手动下线）的区别，避免误配导致服务不可见。
  • Zookeeper 锁功能遗留：若原项目使用 Zookeeper 实现分布式锁，移除 discovery 依赖不会影响 Curator 客户端，但需确保 Curator 依赖未被传递性移除。

参考来源

  • Nacos 官方文档，页面标题：快速开始，URL：https://nacos.io/zh-cn/docs/quick-start.html
  • Spring Cloud Alibaba 官方文档，页面标题：服务发现，URL：https://spring-cloud-alibaba-group.github.io/github-pages/hoxton/zh-cn/docs.html
  • Spring Cloud 版本说明，URL：https://spring.io/projects/spring-cloud