← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第28章 开源项目源码精读 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

28.1.1 Nacos 配置中心:三层存储与长轮询推送

审校 2026-09-26 · 素材来源:zcode会话#12《Nacos功能设计模式与分布式场景解析》(nacos-2.3.1源码)
📑 本篇章节导航 (共9节,点击直达)
场景:一次配置发布的旅程三层存储:数据库、磁盘、内存各管一摊最小可跑示例:亲手感受长轮询原理拆解:长轮询的完整时序发布流程与灰度路由变更之后:事件驱动的落地链配置加密:一个前缀背后的插件体系踩坑清单面试怎么问

线上改一个线程池参数,你是重启五百个实例,还是等三十秒自动生效?Nacos 配置中心解决的就是这件事。这篇拆两个问题:配置存在哪、变更怎么通知到客户端。

前置阅读:16.2 讲过 Nacos 的基础用法。这篇钻进源码,看配置存储与长轮询怎么实现。

场景:一次配置发布的旅程

你在控制台把 thread.pool.size 从 8 改成 16,点发布。三秒后,所有订阅这个配置的服务热更新,全程不重启。

这背后是一套「三层存储 + 长轮询」的组合拳。先看数据放在哪。

三层存储:数据库、磁盘、内存各管一摊

类比图书馆:数据库是仓库(全量真本),磁盘是馆内书架(缓存副本),内存是管理员手边的卡片(只记摘要)。


请求 → JVM 内存(CacheItem,只存 md5 + 时间戳)
     → 磁盘文件(ConfigDiskService,存完整 content)
     → 数据库(derby 嵌入式 / mysql 外置,唯一真源)

三层各有分工:

1. 数据库是真源(source of truth,全量数据的唯一权威副本),存完整配置内容、md5、加密密钥

2. 磁盘是缓存层,启动时由 DumpService 全量落盘,变更时增量补写

3. JVM 内存是最热的一层,只存 md5 和最后修改时间,不存大内容

最妙的是第三层:比对配置有没有变,只需要比 md5,没必要把几 KB 的配置内容都放内存。这是典型的「热路径放轻数据,冷路径放重数据」。

长轮询(Long Polling,客户端发一个请求、服务端捏住最多 30 秒不放的通信方式)就建立在这层 md5 上。

最小可跑示例:亲手感受长轮询


# 1. docker 起一个单机 Nacos(derby 存储)
docker run -d -p 8848:8848 -e MODE=standalone nacos/nacos-server:v2.3.1

# 2. 发布一条配置
curl -X POST 'http://{{NACOS_HOST}}:8848/nacos/v1/cs/configs' \
  -d 'dataId=app.properties&group=DEFAULT&content=pool.size=8'

# 3. 客户端监听(配合 @NacosValue / @RefreshScope 使用)
#    改成 pool.size=16 并发布,观察客户端日志秒级打印刷新记录

原理拆解:长轮询的完整时序

源码入口在 LongPollingService,三步走完:

1. 先比对:客户端请求到达,addLongPollingClient 先 compareMd5——有变更直接返回,一秒都不等

2. 没变更就挂起:req.startAsync() 创建 AsyncContext(Servlet 3.0 的异步上下文,把请求线程还回容器、请求本身继续挂着),丢进 allSubs 队列,默认 30 秒超时

3. 变更时唤醒:配置发布触发 DataChangeTask,遍历 allSubs,命中同一个 groupKey 的客户端立即返回

为什么不用真推送?纯推(如 UDP)不可靠,丢了没补救;纯拉(短轮询)延迟高还空转。长轮询是折中:客户端始终有一条等待中的请求,服务端有变化立刻借这条连接返回。

2.x 客户端在此之上又加了 gRPC 长连接推送(RpcConfigChangeNotifier),但服务端兼容老客户端的长轮询通道依然保留。

发布流程与灰度路由

ConfigController.publishConfig 进来后走 ConfigOperationService.publishConfig,按参数路由到三个分支:

分支持久化服务用途
普通配置ConfigInfoPersistService全量生效
带 tagConfigInfoTagPersistService标签灰度
带 betaIpsConfigInfoBetaPersistService指定 IP 灰度

灰度的正确姿势值得展开:改了数据源配置不敢全量放,先带 betaIps 发给两台灰度机观察;验证通过再发正式版,最后删掉 beta 规则。灰度是发布手段,不是最终状态——三套持久化服务各自建表存储,客户端比对 md5 时也按「先查灰度、再查正式」的顺序命中。

发布链路的入口是 ConfigController.publishConfig,落进 ConfigOperationService.publishConfig 做三分支路由。控制器薄、服务层厚,一层只做参数校验和路由——这个分层在 Nacos 各模块里反复出现,读熟一个就通了全部。

单机用 derby、集群切 mysql,靠 @Conditional 条件装配选实现,SQL 方言差异走 SPI 加载不同的 ConfigInfoMapper。策略选择做在 Spring 容器层,不是 if-else 硬编码。

变更之后:事件驱动的落地链

发布接口返回成功,配置的旅程才走了一半。落盘、唤醒、推送这条链路,靠 NotifyCenter(Nacos 自研事件总线,观察者模式)串起来:


配置发布 → NotifyCenter 发布 LocalDataChangeEvent
  → DumpTask:增量 dump 落磁盘
  → DataChangeTask:唤醒 allSubs 里挂起的长轮询
  → RpcConfigChangeNotifier:gRPC 通道主动推送

三个消费者各干各的,互不知晓——发布方只管扔事件。这就是观察者模式在长链路里的价值:新增一个「配置变更后要做的事」,加一个订阅者就行,不动发布代码。

事件总线本身也值得看:单线程加队列的消费模型,事件顺序有保证,比 Spring Event 的线程池模型更可控。做配置类中间件可以直接抄这个骨架。

配置加密:一个前缀背后的插件体系

配置里的数据库密码、第三方密钥不能明文存。Nacos 的做法很克制:dataId 以 cipher- 开头就走加密链路,EncryptionHandler 通过 SPI 加载 EncryptionPluginService(AES/SM4 都有官方实现)。

三层存储里那个 encrypted_data_key 字段就是为它准备的——密钥跟着配置一起存,客户端拉到密文后用插件解密。加一个新算法等于实现接口加注册 SPI,零侵入。

踩坑清单

面试怎么问

「Nacos 配置变更是推还是拉?」——答:客户端发起长轮询,服务端 hold 住请求,30 秒内有变更立即唤醒返回,没变更超时返回再发起下一轮;2.x 叠加了 gRPC 主动推送。存储上数据库是真源,磁盘和内存 md5 是两级缓存。

追问「为什么内存只存 md5」——比 md5 比对返回的是「变了没有」这个布尔结果,客户端收到通知后再回源拉全量内容;把大内容放内存,几百个 dataId 就能把堆撑爆。通知走轻信道、内容走重信道,是推送系统的通用设计。

一句话总结:三层存储管「放哪」,长轮询管「怎么知道变了」,md5 是两者之间的契约。