https://xumf.net/tags/nacos/ Recent content in Nacos on 小蜜蜂 Hugo -- gohugo.io zh Tue, 03 May 2022 20:54:29 +0800 https://xumf.net/blog/nacos/ Tue, 03 May 2022 20:54:29 +0800 https://xumf.net/blog/nacos/ <h2 id="一nacos-核心概念">一、Nacos 核心概念 </h2><ol> <li><strong>是什么？</strong></li> </ol> <p>Nacos（Dynamic Naming and Configuration Server）是阿里开源的<strong>服务发现+配置管理+服务治理平台</strong>，核心功能：</p> <ul> <li><strong>服务发现与健康监测</strong>：服务注册、心跳机制、DNS 查询</li> <li><strong>动态配置管理</strong>：配置发布、监听、版本管理</li> <li><strong>动态 DNS</strong>：基于权重的路由、地域就近访问</li> <li><strong>服务元数据管理</strong>：支持应用/版本/环境等元数据</li> </ul> <ol start="2"> <li><strong>关键特性</strong> <ul> <li><strong>双模式</strong>：支持 CP（强一致性、如配置管理）和 AP（高可用，如服务发现）</li> <li><strong>配置实时推送</strong>：基于长轮询（减少无效请求）</li> <li><strong>生态兼容</strong>：无缝集成 Spring Cloud、Dubbo、Kubernetes</li> </ul> </li> </ol> <h2 id="二核心架构与原理">二、核心架构与原理 </h2><ol> <li><strong>服务注册与发现流程</strong> <ul> <li><strong>注册</strong>：服务启动时向 Nacos Server 发送注册请求（HTTP/gRPC）</li> <li><strong>心跳</strong>：客户端定期发送心跳（默认5秒），超时（15秒）标记为不健康，30秒后剔除</li> <li><strong>发现</strong>：消费者通过订阅机制获取服务列表，本地缓存+增量更新</li> </ul> </li> <li><strong>配置管理机制</strong> <ul> <li><strong>发布配置</strong>：通过控制台/API发布配置，存储于 Derby 或 MySQL</li> <li><strong>监听配置</strong>：客户端长轮询（默认30秒），服务端 Hold 住请求，配置变更立即返回</li> <li><strong>历史版本</strong>：支持配置回滚和版本对比</li> </ul> </li> <li><strong>一致性协议</strong> <ul> <li><strong>CP 模式</strong>：使用 Raft 协议（配置管理场景）</li> <li><strong>AP 模式</strong>：自研 <a class="link" href="https://nacos.io/zh-cn/blog/nacos-distro-mechanism/" target="_blank" rel="noopener" >Distro 协议</a>（服务发现场景，最终一致性）</li> </ul> </li> </ol> <h2 id="三重要知识点">三、重要知识点 </h2><ol> <li><strong>Nacos vs Eureka vs Zookeeper？</strong> <ul> <li><strong>Eureka</strong>：AP 设计，适合服务发现，但功能单一</li> <li><strong>Zookeeper</strong>：CP 设计，强一致性，但写性能低</li> <li><strong>Nacos</strong>：AP/CP 可切换，集成服务发现+配置管理，生态更全面</li> </ul> </li> <li><strong>长轮询如何实现配置实时推送？</strong> <ul> <li>客户端发起查询请求，若配置无变化，服务端 Hold 请求至超时（默认30秒）或期间配置变更立即返回</li> <li>对比传统轮询：减少无效请求，提升实时性</li> <li>对比 WebSocket：长轮询服务端实现更简单，但存在30秒最大延迟（非实时配置场景选长轮询即可，实时性要求极高场景考虑 gRPC 流式推送）</li> </ul> </li> <li><strong>Nacos 集群如何保证数据一致性？</strong> <ul> <li><strong>Distro 模式（AP 模式）</strong>：每个节点负责部分数据，通过异步复制保证最终一致性。写入时先写本地，再异步复制到其他节点；读取时可能读到旧数据，但通常可接受（服务发现场景对一致性要求不高）。</li> <li><strong>Raft 协议（CP 模式）</strong>：选举 Leader，多数节点写成功才返回。适用于配置管理——配置错了影响面大，宁可不更新也不能不一致。</li> </ul> </li> <li><strong>Nacos 2.0 升级了哪些内容？</strong> <ul> <li><strong>通信层优化</strong>：gRPC 替代 HTTP，减少连接数（1.x 每个客户端与 server 维持多个 HTTP 长连接，2.0 全复用为一条 gRPC 连接）</li> <li><strong>长连接增强</strong>：支持服务端主动推送，降低延迟</li> <li><strong>性能提升</strong>：支撑百万级服务实例</li> </ul> </li> <li><strong>如何实现配置灰度发布？</strong> <ul> <li>通过 <strong>Data ID 或 Group</strong> 分组，结合 Spring Cloud 的 <code>@RefreshScope</code> 或监听 <code>ConfigChangeEvent</code> 实现部分实例更新</li> <li>更优雅的方式：使用 Nacos 的 Beta 发布功能——指定目标 IP 列表，只有命中 IP 的客户端拉取到灰度配置。验证无误后再全量发布。</li> </ul> </li> </ol> <h2 id="四实战场景与排查思路">四、实战场景与排查思路 </h2><ol> <li><strong>服务注册失败常见原因</strong> <ul> <li>网络不通：检查 Nacos Server 地址和端口（telnet 或 nc 测试连通性）</li> <li>版本冲突：Spring Cloud Alibaba 与 Nacos 版本不兼容 → 参考官方版本对应表</li> <li>命名空间/Group 配置错误：客户端 <code>namespace</code> 和 <code>group</code> 须与服务端一致，命名空间为空时默认使用 public</li> <li>防火墙/安全组拦截：gRPC 端口（9848/9849）需额外开放</li> </ul> </li> <li><strong>配置不生效排查步骤</strong> <ul> <li>检查控制台配置是否发布成功（Data ID、Group、命名空间与客户端代码匹配）</li> <li>检查 <code>@RefreshScope</code> 是否加在正确的位置——标注在 @Configuration 类上可能导致整个类重新创建，注意副作用</li> <li>查看日志：<code>com.alibaba.nacos.client.config.listener</code> 包日志是否有监听异常</li> <li>长轮询超时确认：查看请求日志中 HTTP 状态码是否为 200（非 304 表示配置变更）</li> </ul> </li> <li><strong>Nacos 集群部署注意事项</strong> <ul> <li>至少 3 个节点形成 Raft 选举（节点数建议奇数，避免脑裂）</li> <li>使用 MySQL 作为外部存储（Derby 仅适合单机测试——集群模式下不使用 MySQL 会导致各节点数据不一致）</li> <li>所有节点配置文件中的 <code>cluster.conf</code> 必须包含所有节点地址</li> <li>通过 Nginx 做负载均衡时，gRPC 长连接需要配置 <code>upstream</code> 为 <code>ip_hash</code> 或使用 <code>nginx-stream</code> 模块</li> </ul> </li> </ol> <h2 id="五高级话题">五、高级话题 </h2><ol> <li><strong>Nacos-Sync 应用</strong> <ul> <li>跨注册中心同步（如 Kubernetes Service 到 Nacos、Eureka 迁移到 Nacos）</li> <li>本质是事件监听+双向同步，注意循环同步问题（A→B→A 死循环），Nacos-Sync 通过记录同步来源避免</li> </ul> </li> <li><strong>安全控制</strong> <ul> <li>开启鉴权：<code>nacos.core.auth.enabled=true</code>，配置自定义用户角色</li> <li>重要：Nacos 2.2.3 之前默认鉴权不开启，且密钥为硬编码，务必修改 <code>nacos.core.auth.plugin.nacos.token.secret.key</code></li> </ul> </li> <li><strong>双活部署</strong> <ul> <li>多数据中心通过 Nacos-Sync 同步数据，结合 DNS 实现流量切换</li> <li>注意：跨地域同步存在网络延迟，配置变更可能在数秒后才能传播到异地——不要依赖 Nacos 跨地域强一致</li> </ul> </li> </ol>