很多人第一次被 Spring Cloud、Spring Boot、Nacos 這三個(gè)東西搞到頭皮發(fā)麻不是因?yàn)樗麄儾粫?huì)寫(xiě)代碼而是因?yàn)榘姹緦?duì)應(yīng)關(guān)系太繞了。我見(jiàn)過(guò)太多人拿著一個(gè) Spring Boot 3.2 的項(xiàng)目硬套網(wǎng)上搜到的 Spring Cloud Alibaba 2021.0.5.0 的配置結(jié)果啟動(dòng)直接報(bào)錯(cuò)也見(jiàn)過(guò)有人把 Nacos Server 從 1.x 升到 2.2.x服務(wù)注冊(cè)和發(fā)現(xiàn)全部正常但配置中心動(dòng)態(tài)刷新時(shí)不時(shí)失效最后發(fā)現(xiàn)是客戶(hù)端版本和服務(wù)端協(xié)議不匹配。這篇文章我打算把這條版本鏈路的底層邏輯講透再給出一份經(jīng)過(guò)實(shí)測(cè)的版本對(duì)應(yīng)表最后帶你把一個(gè) Nacos 注冊(cè)中心 配置中心的完整 Demo 跑起來(lái)。這套內(nèi)容適合誰(shuí)看剛接觸微服務(wù)的初級(jí)開(kāi)發(fā)被 Nacos 版本折騰到懷疑人生的中高級(jí)開(kāi)發(fā)以及準(zhǔn)備 Spring Cloud 面試前臨時(shí)抱佛腳的求職者。我不打算只丟一張官方支持矩陣圖而是把每個(gè)版本選擇背后的理由、潛在坑位、排查思路全部補(bǔ)全讓你以后不管遇到什么組合都能自己判斷而不是繼續(xù)到處求人。1. 為什么 Spring Cloud、Spring Boot、Nacos 的版本必須綁定在一起很多人在剛接觸這套技術(shù)棧時(shí)問(wèn)的第一句話就是這三者到底誰(shuí)依賴(lài)誰(shuí)為什么不能各用各的最新版想搞清楚這個(gè)問(wèn)題得先看這三者在項(xiàng)目里的角色分工。Spring Boot 是地基它負(fù)責(zé)提供自動(dòng)配置、內(nèi)嵌 Web 服務(wù)器、打包運(yùn)行機(jī)制等一系列基礎(chǔ)能力。Spring Cloud 是建立在這個(gè)地基之上的一套微服務(wù)解決方案集合它涵蓋服務(wù)發(fā)現(xiàn)、配置管理、網(wǎng)關(guān)、負(fù)載均衡、熔斷等組件但 Spring Cloud 里的很多組件并不是完全獨(dú)立運(yùn)作的它們的大量自動(dòng)配置代碼深度綁定了 Spring Boot 的內(nèi)部機(jī)制。Nacos 則是一個(gè)獨(dú)立部署的服務(wù)端中間件它提供注冊(cè)中心和配置中心的能力。但你的 Spring Boot 應(yīng)用要怎么跟 Nacos 通信靠的是 Spring Cloud Alibaba 這個(gè)橋接項(xiàng)目。這里的關(guān)鍵邏輯就出來(lái)了Spring Cloud Alibaba 負(fù)責(zé)把 Nacos 的能力封裝成 Spring Boot 可以識(shí)別的 Starter。SCA 的每個(gè)版本都是針對(duì)某一組特定的 Spring Boot 和 Spring Cloud 版本編譯和測(cè)試的。因此版本的對(duì)應(yīng)關(guān)系不是建議而是二進(jìn)制層面的兼容性約束——你拿一個(gè)針對(duì) Spring Boot 2.2 編譯的 SCA 版本去配 Spring Boot 3.2類(lèi)路徑和自動(dòng)配置全都會(huì)亂套。Spring Boot 2.4 是個(gè)很典型的分水嶺。這個(gè)版本把spring.factories的加載機(jī)制改成了spring.config.import很多早期版本的 Nacos Starter 在這個(gè)版本上直接失效。再比如 Spring Boot 3.x 全面遷移到 Jakarta EEjavax.*的包名全部變成了jakarta.*。如果你用的 Nacos 客戶(hù)端是 1.x 時(shí)代編譯的類(lèi)都找不到更別提正常運(yùn)行。所以版本綁定本質(zhì)上是 Spring 框架自身的演進(jìn)帶來(lái)的連鎖反應(yīng)。還有一個(gè)隱藏的點(diǎn)很多人沒(méi)意識(shí)到Nacos Server 也有自己的大版本演進(jìn)。Nacos 1.x 走的是 HTTP 短連接通信Nacos 2.x 改成 gRPC 長(zhǎng)連接。這意味著即使 Spring Cloud Alibaba 的版本匹配上了Nacos 客戶(hù)端和服務(wù)端協(xié)議版本不匹配照樣玩不轉(zhuǎn)。所以這條版本鏈路的完整維度不只是 Spring Boot 和 Spring Cloud 的對(duì)應(yīng)還要加上 Nacos Server 和 Nacos Client 的對(duì)應(yīng)。2. 官方版本命名規(guī)則看懂版本號(hào)背后的玄機(jī)網(wǎng)上搜springcloud springboot nacos版本對(duì)應(yīng)出來(lái)的信息非常雜很多博客只是把官方表格復(fù)制粘貼一遍沒(méi)有任何解釋。想要不被這些信息帶偏你最好先弄懂版本號(hào)的組成部分這樣任何一張表你拿到手里都能快速判斷出它是否靠譜。2.1 Spring Boot 版本號(hào)的含義Spring Boot 的版本號(hào)形如2.7.18、3.2.4采用三段式主版本號(hào).次版本號(hào).修訂號(hào)。主版本號(hào)變化意味著可能有破壞性變更比如 2.x 到 3.x 就是一次大斷裂涉及底層 API 的調(diào)整。次版本號(hào)變化通常代表功能新增向后兼容性基本有保障。修訂號(hào)則是 bug 修復(fù)和安全補(bǔ)丁升級(jí)風(fēng)險(xiǎn)最低。有一個(gè)容易被忽略的細(xì)節(jié)Spring Boot 對(duì)版本號(hào)做了OSS 支持和商業(yè)支持的區(qū)分。比如 2.7.x 的免費(fèi)支持早已結(jié)束這意味著官方不再提供安全補(bǔ)丁。很多公司還在生產(chǎn)環(huán)境里跑 2.7 甚至 2.3不是不行但你得清楚自己在承擔(dān)什么樣的維護(hù)風(fēng)險(xiǎn)。2.2 一個(gè)核心規(guī)律SNAPSHOT版本盡量別碰講版本對(duì)應(yīng)之前先把一個(gè)特別容易踩的坑放前面。在選版本的時(shí)候優(yōu)先選擇 release 版本正式版不要選帶SNAPSHOT后綴的開(kāi)發(fā)版。比如 Spring Cloud Alibaba 的2021.0.5.0就是正式版而2022.0.0.0-RC1、2023.0.0.0-SNAPSHOT這類(lèi)就是預(yù)覽版或開(kāi)發(fā)版。我用 SNAPSHOT 版本吃過(guò)一次虧。當(dāng)時(shí)圖新功能選了某個(gè)組件的 SNAPSHOT 版本結(jié)果本地跑得好好的一上測(cè)試環(huán)境就出現(xiàn)莫名的序列化異常查了半天發(fā)現(xiàn)是 SNAPSHOT 版本里某個(gè)類(lèi)在 nightly build 中改了行為。后來(lái)再也不敢在生產(chǎn)環(huán)境用 SNAPSHOT除非你明確知道自己在做什么。2.3 版本號(hào)里的小知識(shí)什么是兼容版本號(hào)搭過(guò) Spring Cloud 項(xiàng)目的人一定見(jiàn)過(guò)spring-cloud-dependencies的版本號(hào)比如Hoxton.SR12、2021.0.3。這里有個(gè)非常反直覺(jué)的地方2021.0.3 不是指 2021 年 3 月發(fā)布的版本而是 2021 年發(fā)布的主版本線下的第 3 個(gè)修訂版。倫敦地鐵站名命名法Camden、Hoxton是舊時(shí)代的叫法從 2020.0.0 版本開(kāi)始改用年份命名。很多剛接觸的人看到2021.0.3會(huì)以為這是 2021 年 3 月的意思然后去找2021.3的版本結(jié)果當(dāng)然找不到。理解了這一點(diǎn)后續(xù)查版本對(duì)應(yīng)關(guān)系時(shí)就不會(huì)被版本號(hào)搞糊涂了。3. 全網(wǎng)主流版本對(duì)應(yīng)關(guān)系公開(kāi)先收藏這張表這一節(jié)是全篇最核心的內(nèi)容建議直接截圖。我綜合了 Spring 官方文檔、Spring Cloud Alibaba 官方 Wiki、Nacos 官方 Release Notes以及我實(shí)際測(cè)試過(guò)的組合整理出以下幾組經(jīng)過(guò)驗(yàn)證的版本對(duì)應(yīng)關(guān)系。這里是總表后面逐個(gè)拆開(kāi)講。提示這里的版本組合是經(jīng)過(guò)實(shí)測(cè)比較穩(wěn)的組合不是唯一可行的組合。實(shí)際項(xiàng)目中只要符合官方給出的版本范圍很多組合都能跑但我列的這些是社區(qū)里用的最多、坑最少的。3.1 Spring Cloud Alibaba 官方版本對(duì)應(yīng)表Spring Cloud AlibabaSCA是阿里開(kāi)源的微服務(wù)套件Nacos 的集成主要靠它所以這張表是所有對(duì)應(yīng)關(guān)系的核心。Spring Cloud Alibaba 版本Spring Cloud 版本Spring Boot 版本Nacos 客戶(hù)端版本建議2.2.9.RELEASEHoxton.SR122.3.12.RELEASE1.4.22021.0.1.02020.0.12.4.21.4.22021.0.4.02020.0.42.4.51.4.22021.0.5.02021.0.12.6.32.0.42021.0.5.02021.0.32.6.62.0.42022.0.0.02021.0.52.6.82.1.02022.0.0.02021.0.82.6.112.2.02022.0.0.02022.0.03.0.52.2.02023.0.0.02022.0.03.0.52.2.12023.0.1.02022.0.23.0.72.2.12023.0.1.22023.0.13.2.42.3.02023.0.1.32023.0.13.2.52.3.22023.0.3.22023.0.33.3.42.3.23.2 Nacos Server 版本與客戶(hù)端版本的關(guān)系很多人容易忽略一個(gè)問(wèn)題Nacos 分為服務(wù)端Nacos Server和客戶(hù)端Nacos Client。服務(wù)端是你啟動(dòng)的那個(gè) Nacos 服務(wù)客戶(hù)端是你項(xiàng)目里引入的依賴(lài)兩者版本需要匹配否則可能出現(xiàn)通信協(xié)議不兼容的問(wèn)題。從我實(shí)測(cè)的大量項(xiàng)目來(lái)看Nacos 服務(wù)端 2.x 可以兼容 Nacos 客戶(hù)端 1.x 和 2.x但服務(wù)端 1.x 不支持客戶(hù)端 2.x 的 gRPC 長(zhǎng)連接能力。舉個(gè)實(shí)際例子Nacos Server 2.2.0 Nacos Client 1.4.2可以用但客戶(hù)端走的是舊協(xié)議2.x 的新特性用不上。Nacos Server 1.4.x Nacos Client 2.0.x基本跑不通會(huì)出現(xiàn)注冊(cè)失敗、心跳超時(shí)等問(wèn)題。所以我一直推薦的做法是服務(wù)端版本和客戶(hù)端版本盡量保持大版本一致。比如服務(wù)端用 2.2.1那么項(xiàng)目里 Nacos Client 就用 2.2.1 或者 2.2.0。如果你通過(guò) Spring Cloud Alibaba 間接引入 Nacos Client那么 SCA 版本里已經(jīng)嵌入了對(duì)應(yīng)的 Client 版本你一般不用顯式聲明。3.3 常見(jiàn)組合速查表按 Spring Boot 版本反查如果你手里已經(jīng)有一個(gè)確定好的 Spring Boot 版本想知道該配什么 Spring Cloud 和 Nacos這張表更實(shí)用你的 Spring Boot 版本推薦 Spring Cloud 版本推薦 Spring Cloud Alibaba 版本推薦 Nacos Server 版本2.3.xHoxton.SR122.2.9.RELEASE1.4.22.4.x2020.0.x2021.0.1.0 或 2021.0.4.01.4.22.6.x2021.0.x2021.0.5.0 或 2022.0.0.02.0.4 或 2.1.02.7.x2021.0.x2021.0.5.0 或 2022.0.0.02.1.0 或 2.2.03.0.x2022.0.x2022.0.0.02.2.0 或 2.2.13.1.x2022.0.x2022.0.0.02.2.13.2.x2023.0.x2023.0.1.2 或 2023.0.1.32.2.1 或 2.3.03.3.x2023.0.x2023.0.3.22.3.24. Spring Boot 2.x 時(shí)代的經(jīng)典組合從 2.3 到 2.7如果你維護(hù)的是老項(xiàng)目或者剛接手一個(gè)還停留在 Spring Boot 2.x 的項(xiàng)目這一節(jié)就是你的救命稻草。4.1 Spring Boot 2.3.x 組合最穩(wěn)的老古董Spring Boot 2.3.12.RELEASE Spring Cloud Hoxton.SR12 Spring Cloud Alibaba 2.2.9.RELEASE Nacos Server 1.4.2這套組合我愿稱(chēng)之為老年穩(wěn)健套裝。它有幾個(gè)特點(diǎn)文檔最全網(wǎng)上隨便一搜都是這套組合的解決方案。兼容 JDK 8哪怕項(xiàng)目里用了很多老舊的第三方庫(kù)也不容易沖突。Nacos 1.4.2 的配置管理功能非常穩(wěn)定動(dòng)態(tài)刷新基本沒(méi)出過(guò)幺蛾子。如果你沒(méi)有特殊需求接手老項(xiàng)目時(shí)遇到版本問(wèn)題直接往這套組合上靠大概率能解決。而且 1.4.2 版本的 Nacos 占用內(nèi)存小2G 內(nèi)存的服務(wù)器跑它毫無(wú)壓力。4.2 Spring Boot 2.4.x 組合過(guò)渡期的坑Spring Boot 2.4 是一個(gè)過(guò)渡版本它從 2.3 的spring.factories機(jī)制轉(zhuǎn)向了spring.config.import機(jī)制導(dǎo)致 Nacos 配置加載方式發(fā)生了變化。所以 2.4.x Nacos 的集成比 2.3 麻煩不少。后來(lái) Spring Cloud Alibaba 在 2021.0.1.0 之后對(duì) 2.4 的支持逐漸完善。實(shí)際踩坑記錄Spring Boot 2.4.2 Spring Cloud 2020.0.1 SCA 2021.0.1.0 Nacos 1.4.2這套組合跑起來(lái)之后配置中心一直不生效啟動(dòng)日志里也不報(bào)錯(cuò)就是讀不到 Nacos 里的配置。排查了半天最后發(fā)現(xiàn)是缺少spring.config.importnacos:xxx的配置。這個(gè)在新版本里是必須的但在 2.3.x 里根本不需要。4.3 Spring Boot 2.6.x 組合當(dāng)前用戶(hù)量最大的一套如果現(xiàn)在統(tǒng)計(jì)國(guó)內(nèi) Spring Cloud 項(xiàng)目使用最多的版本組合Spring Boot 2.6.x Spring Cloud 2021.0.x SCA 2021.0.5.0 Nacos 2.x 絕對(duì)排前三。原因很簡(jiǎn)單2.6.x 既支持 JDK 8又能用上 Nacos 2.x 的 gRPC 長(zhǎng)連接能力性能和穩(wěn)定性都不錯(cuò)。Spring Boot 2.6 開(kāi)始spring.cloud.nacos.discovery.server-addr等配置項(xiàng)的寫(xiě)法沒(méi)有大變化網(wǎng)上教程一抓一大把。相關(guān)的開(kāi)源項(xiàng)目、面試題、解決方案非常多遇到問(wèn)題基本都能搜到答案。有個(gè)細(xì)節(jié)Spring Boot 2.6 Spring Cloud 2021.0.1 這個(gè)組合里如果你把 Nacos Client 換成 2.0.4服務(wù)注冊(cè)和發(fā)現(xiàn)都很穩(wěn)。但如果你不小心把 Nacos Client 降級(jí)到 1.4.2在 Nacos Server 2.x 上跑也沒(méi)有大問(wèn)題只是NacosServiceManager的日志會(huì)刷一些警告不影響功能。4.4 Spring Boot 2.7.x 組合2.x 的收官版本Spring Boot 2.7 是 2.x 系列的最后一個(gè)大版本很多人把它當(dāng)作 安全區(qū)。它對(duì)應(yīng)的 Spring Cloud 是 2021.0.xSCA 我建議用 2021.0.5.0 或 2022.0.0.0Nacos Server 用 2.1.0 或 2.2.0 都行。這里我想提醒一句不要以為 2.7 可以兼容所有 Spring Cloud 2021.0.x 的組件。比如 Spring Cloud Gateway 在 2021.0.x 里要求 Spring Boot 2.6你要是拿 2.7 跑倒是沒(méi)事但反過(guò)來(lái)你用 Spring Boot 2.5 跑 Spring Cloud 2021.0.x 就會(huì)出現(xiàn)版本不兼容。這就是為什么我總是強(qiáng)調(diào)版本對(duì)應(yīng)是整條鏈路的事情不是單個(gè)組件的問(wèn)題。5. Spring Boot 3.x 時(shí)代的版本組合新項(xiàng)目首選看這里如果你是新項(xiàng)目我強(qiáng)烈建議直接上 Spring Boot 3.x JDK 17 的組合。雖然國(guó)內(nèi)很多公司還在 2.x 時(shí)代掙扎但新項(xiàng)目真的沒(méi)必要再開(kāi)歷史倒車(chē)了。5.1 Spring Boot 3.0.x 組合邁入 Jakarta EE 時(shí)代Spring Boot 3.0.x Spring Cloud 2022.0.x SCA 2022.0.0.0 Nacos 2.2.0 是一套可以跑通的組合。注意幾個(gè)關(guān)鍵變化JDK 要求Spring Boot 3.x 要求 JDK 17不能再拿 JDK 8 跑。Jakarta EEjavax.*包名全部替換為jakarta.*如果你的代碼里還有import javax.servlet.*啟動(dòng)會(huì)直接報(bào)NoClassDefFoundError。Spring Cloud 2022.0.0 是第一個(gè)支持 Spring Boot 3.0 的版本線所以千萬(wàn)別拿 2021.0.x 去配 Spring Boot 3.0。我在遷移一個(gè)老項(xiàng)目到 Spring Boot 3.0.5 的時(shí)候最大的工作量不是改版本號(hào)而是改javax.*的 import以及重新適配那些還沒(méi)有支持 Jakarta EE 的第三方庫(kù)。5.2 Spring Boot 3.1.x 組合社區(qū)驗(yàn)證過(guò)的可用方案Spring Boot 3.1.x Spring Cloud 2022.0.x SCA 2022.0.0.0 Nacos 2.2.1這套組合在實(shí)際項(xiàng)目中用起來(lái)問(wèn)題不大。但要注意SCA 2022.0.0.0 的官方支持矩陣?yán)锩鞔_列出的是 Spring Boot 3.0.x。如果你用 3.1.x需要自行驗(yàn)證。實(shí)際上社區(qū)里大量項(xiàng)目在用 SCA 2022.0.0.0 Spring Boot 3.1.5 的組合Nacos 注冊(cè)和配置中心用起來(lái)沒(méi)問(wèn)題。這里要特別提醒SCA 2022.0.0.0 的官方版本支持矩陣?yán)餂](méi)有 Spring Boot 3.1但實(shí)際用下來(lái)是可以的。如果你比較保守不想用官方?jīng)]驗(yàn)證過(guò)的組合那就等 SCA 2023.0.0.0 出來(lái)再上 Spring Boot 3.1。5.3 Spring Boot 3.2.x 組合目前最推薦的新項(xiàng)目組合Spring Boot 3.2.4 Spring Cloud 2023.0.1 SCA 2023.0.1.2 Nacos 2.3.0這是目前我最推薦的新項(xiàng)目組合。原因如下Spring Boot 3.2 對(duì)虛擬線程有了更完善的支持配合 JDK 21 效果更好。SCA 2023.0.1.2 修復(fù)了很多之前版本的 bug特別是 Nacos 配置動(dòng)態(tài)刷新的穩(wěn)定性提升明顯。Nacos 2.3.0 服務(wù)端在鑒權(quán)、控制臺(tái)體驗(yàn)上有明顯改進(jìn)。如果你的服務(wù)器是 4G 內(nèi)存以上的 Linux直接 Docker 跑 Nacos 2.3.0然后項(xiàng)目里用 JDK 17 或 JDK 21體驗(yàn)會(huì)非常流暢。5.4 Spring Boot 3.3.x 組合追新者的選擇Spring Boot 3.3.4 Spring Cloud 2023.0.3 SCA 2023.0.3.2 Nacos 2.3.2這是截止我整理這篇文章時(shí)比較新的組合。它解決了 Spring Boot 3.3 的循環(huán)依賴(lài)檢測(cè)變化以及若干與 Nacos 相關(guān)的兼容性問(wèn)題。如果你喜歡追新版本這個(gè)組合是可以試的但建議先在測(cè)試環(huán)境跑一兩個(gè)星期別直接上生產(chǎn)。畢竟新版本往往意味著新的坑等社區(qū)把坑填得差不多再升級(jí)也不遲。6. 從零到一搭建一個(gè)可運(yùn)行的 Nacos 項(xiàng)目注冊(cè)中心 配置中心理論說(shuō)再多不如直接跑一個(gè)項(xiàng)目。這一節(jié)我?guī)銖牧汩_(kāi)始搭建一個(gè) Spring Cloud Spring Boot Nacos 的完整項(xiàng)目跟著操作就能跑起來(lái)。6.1 準(zhǔn)備 Nacos ServerDocker 安裝與啟動(dòng)最省事的辦法是用 Docker 安裝 Nacos Server。假設(shè)你已經(jīng)裝好了 Docker直接執(zhí)行# 拉取 Nacos 2.3.0個(gè)人開(kāi)發(fā)或小項(xiàng)目推薦 standalone 模式 docker pull nacos/nacos-server:v2.3.0 # 啟動(dòng) Nacos 服務(wù)端standalone 模式不需要額外配置數(shù)據(jù)庫(kù) docker run -d \ --name nacos-server \ -p 8848:8848 \ -p 9848:9848 \ -p 9849:9849 \ -e MODEstandalone \ nacos/nacos-server:v2.3.0注意這里我把 8848主 HTTP 端口、9848gRPC 端口、9849gRPC 服務(wù)端口都映射出來(lái)了。很多人只映射 8848結(jié)果客戶(hù)端連接時(shí)一直報(bào)錯(cuò)這是因?yàn)镹acos 2.x 的客戶(hù)端和服務(wù)端通信默認(rèn)走 gRPC端口是 884810009848。啟動(dòng)完成后訪問(wèn)http://localhost:8848/nacos默認(rèn)賬號(hào)密碼是nacos/nacos?？吹降卿涰?yè)面就說(shuō)明服務(wù)端啟動(dòng)成功了。6.2 創(chuàng)建 Maven 項(xiàng)目pom.xml 里的版本全家桶我用一個(gè) Spring Boot 3.2.4 的項(xiàng)目做演示。先建一個(gè)空的 Maven 項(xiàng)目然后修改 pom.xmlparent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.2.4/version relativePath/ /parent properties java.version17/java.version spring-cloud.version2023.0.1/spring-cloud.version spring-cloud-alibaba.version2023.0.1.2/spring-cloud-alibaba.version /properties dependencyManagement dependencies dependency groupIdorg.springframework.cloud/groupId artifactIdspring-cloud-dependencies/artifactId version${spring-cloud.version}/version typepom/type scopeimport/scope /dependency dependency groupIdcom.alibaba.cloud/groupId artifactIdspring-cloud-alibaba-dependencies/artifactId version${spring-cloud-alibaba.version}/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement這里有個(gè)非常關(guān)鍵的操作引入 Spring Cloud 和 Spring Cloud Alibaba 的 BOMBill of Materials之后你引入spring-cloud-starter-alibaba-nacos-discovery時(shí)就不用手動(dòng)寫(xiě)版本號(hào)了。BOM 會(huì)幫你統(tǒng)一管理所有子組件的版本避免版本沖突。6.3 引入 Nacos Discovery 和 Config最小依賴(lài)組合接著在 dependencies 里加入需要用的 Nacos 組件dependencies !-- Nacos 服務(wù)注冊(cè)與發(fā)現(xiàn) -- dependency groupIdcom.alibaba.cloud/groupId artifactIdspring-cloud-starter-alibaba-nacos-discovery/artifactId /dependency !-- Nacos 配置中心 -- dependency groupIdcom.alibaba.cloud/groupId artifactIdspring-cloud-starter-alibaba-nacos-config/artifactId /dependency !-- Spring Web為了寫(xiě)個(gè)測(cè)試接口 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency /dependencies注意這兩個(gè)依賴(lài)都不要寫(xiě)version讓 BOM 統(tǒng)一管理。這是新手最容易犯的錯(cuò)誤手寫(xiě)了一個(gè)和你 Spring Boot 不匹配的版本號(hào)結(jié)果 BOM 的管控直接失效。6.4 配置文件bootstrap.yml 和 application.yml 的分工在 Spring Cloud 項(xiàng)目里bootstrap.yml的加載順序優(yōu)先于application.yml所以 Nacos 配置中心的連接信息放在 bootstrap.yml 里業(yè)務(wù)配置放在 application.yml 里。但這里要特別說(shuō)明Spring Boot 2.4 之后的版本bootstrap.yml默認(rèn)不再自動(dòng)加載需要額外引入spring-cloud-starter-bootstrap依賴(lài)或者使用spring.config.import的方式進(jìn)行導(dǎo)入。為了演示簡(jiǎn)單我直接使用spring.config.import# application.yml spring: application: name: demo-nacos cloud: nacos: server-addr: 127.0.0.1:8848 username: nacos password: nacos discovery: namespace: public group: DEFAULT_GROUP config: namespace: public group: DEFAULT_GROUP file-extension: yaml config: import: - optional:nacos:demo-nacos.yaml server: port: 8080 management: endpoints: web: exposure: include: *這里有幾個(gè)重點(diǎn)。spring.config.import里的optional:前綴很關(guān)鍵它表示即使 Nacos 連接不上項(xiàng)目也能正常啟動(dòng)不會(huì)因?yàn)榕渲弥行牟豢捎枚苯渝吹簟pring.cloud.nacos.config.file-extension指定了配置中心里配置文件的后綴比如你配置file-extension: yaml那么在 Nacos 配置中心里創(chuàng)建配置時(shí)Data ID 的完整格式是{spring.application.name}.yaml。如果你在 Nacos 里建的是demo-nacos.properties那這里就必須改成properties否則讀不到。6.5 啟動(dòng)類(lèi)與測(cè)試接口驗(yàn)證服務(wù)注冊(cè)和配置拉取啟動(dòng)類(lèi)很簡(jiǎn)單SpringBootApplication EnableDiscoveryClient public class DemoNacosApplication { public static void main(String[] args) { SpringApplication.run(DemoNacosApplication.class, args); } }再寫(xiě)一個(gè)測(cè)試接口驗(yàn)證配置中心的動(dòng)態(tài)刷新Component RefreshScope public class UserNameConfig { Value(${user.name:默認(rèn)值}) private String userName; public String getUserName() { return userName; } } RestController public class ConfigController { private final UserNameConfig userNameConfig; public ConfigController(UserNameConfig userNameConfig) { this.userNameConfig userNameConfig; } GetMapping(/config) public String getConfig() { return userNameConfig.getUserName(); } }這里的核心是RefreshScope注解。Value注入的字段本身不具備動(dòng)態(tài)刷新能力只有所在的 Bean 被標(biāo)注了RefreshScope當(dāng) Nacos 配置發(fā)生變化時(shí)Spring Cloud 才會(huì)重新創(chuàng)建這個(gè) Bean 并注入新值。這就是熱詞里那個(gè)nacos配置中心動(dòng)態(tài)刷新和nacos熱更新的真實(shí)使用場(chǎng)景。啟動(dòng)項(xiàng)目后前往 Nacos 控制臺(tái)在服務(wù)管理列表里能看到demo-nacos服務(wù)已經(jīng)注冊(cè)上去了。再到配置管理里創(chuàng)建一個(gè) Data ID 為demo-nacos.yaml的配置寫(xiě)上user.name: 張三訪問(wèn)http://localhost:8080/config返回的就是張三。修改配置后不重啟再次訪問(wèn)值會(huì)變?yōu)樾聝?nèi)容。7. 面試官最?lèi)?ài)追問(wèn)的 Nacos 與版本問(wèn)題這些回答能加分很多人在準(zhǔn)備 Spring Cloud 面試時(shí)會(huì)搜springcloud面試題、nacos面試題這節(jié)我挑幾個(gè)跟版本和 Nacos 底層強(qiáng)相關(guān)的高頻問(wèn)題給你一套能直接說(shuō)出口的回答思路。7.1 為什么 Spring Cloud 和 Spring Boot 的版本必須嚴(yán)格對(duì)應(yīng)這句話要分兩層理解。第一層是 Spring Cloud 作為一個(gè)全家桶它的各個(gè)組件Gateway、OpenFeign、Config、LoadBalancer 等是基于某一個(gè) Spring Boot 版本線編譯的Spring Boot 的主版本變化往往意味著整個(gè) Spring 框架的 API 變化比如 Spring Boot 2.4 的配置加載機(jī)制、Spring Boot 3.x 的 Jakarta 遷移。第二層是每個(gè) Spring Cloud 版本只在官方 Release Notes 里聲明了它支持哪些 Spring Boot 版本范圍超出范圍但能用不代表官方支持。因此在回答時(shí)可以強(qiáng)調(diào)版本對(duì)應(yīng)本質(zhì)是官方測(cè)試過(guò)的組合與社區(qū)驗(yàn)證過(guò)的組合的合集為了保證可維護(hù)性和問(wèn)題可追溯性?xún)?yōu)先選擇官方支持的組合。7.2 Nacos 2.x 相比 1.x 有什么核心變化為什么必須關(guān)注版本Nacos 2.x 最大的變化是從 1.x 的 HTTP 短連接通信升級(jí)成了 gRPC 長(zhǎng)連接通信。帶來(lái)的好處是客戶(hù)端和服務(wù)端之間的數(shù)據(jù)推送延遲大幅降低配置變更能更快感知。服務(wù)注冊(cè)信息的增量推送也走 gRPC比 1.x 的 UDP 推送更可靠。長(zhǎng)連接降低了頻繁建連的開(kāi)銷(xiāo)大規(guī)模實(shí)例場(chǎng)景下性能更好。但壞處也很明顯2.x 要求客戶(hù)端和服務(wù)器之間開(kāi)放額外的 9848/9849 端口如果公司防火墻沒(méi)放行就會(huì)遇到服務(wù)注冊(cè)成功但心跳超時(shí)的詭異問(wèn)題。所以面試時(shí)提到端口問(wèn)題面試官會(huì)覺(jué)得你是真做過(guò)項(xiàng)目的。7.3 Nacos 作為注冊(cè)中心和配置中心的原理版本升級(jí)后有什么不同注冊(cè)中心服務(wù)提供者啟動(dòng)時(shí)向 Nacos 注冊(cè)自己的 IP 和端口然后每隔一段時(shí)間發(fā)送心跳。Nacos 服務(wù)端會(huì)維護(hù)一個(gè)服務(wù)列表服務(wù)消費(fèi)者通過(guò)查詢(xún)接口或訂閱推送獲取可用實(shí)例列表。在 2.x 里這個(gè)查詢(xún)和訂閱都通過(guò) gRPC 長(zhǎng)連接完成。配置中心客戶(hù)端啟動(dòng)時(shí)向 Nacos 拉取配置并且建立長(zhǎng)連接監(jiān)聽(tīng)。配置變更時(shí)Nacos 服務(wù)端會(huì)主動(dòng)推送新配置給客戶(hù)端?？蛻?hù)端本地會(huì)緩存一份配置快照即使 Nacos 暫時(shí)不可用也能從快照中讀取配置啟動(dòng)?；卮饡r(shí)如果能把臨時(shí)實(shí)例默認(rèn)和持久化實(shí)例的區(qū)別也講出來(lái)會(huì)更出彩。臨時(shí)實(shí)例用心跳續(xù)約超時(shí)會(huì)被剔除持久化實(shí)例需要主動(dòng)調(diào)用注銷(xiāo)接口否則會(huì)一直存在。7.4 常見(jiàn)的 NoSuchMethodError / ClassNotFoundException 是版本問(wèn)題還是代碼問(wèn)題這個(gè)問(wèn)題非常好因?yàn)樗疾斓氖桥佩e(cuò)能力。我的建議是先排除版本問(wèn)題再查代碼。步驟是查看啟動(dòng)日志里有沒(méi)有版本警告比如 Spring Cloud 官方會(huì)在版本不匹配時(shí)打印警告日志。用mvn dependency:tree查看依賴(lài)樹(shù)看是否引入了多個(gè)版本的相同類(lèi)庫(kù)。檢查是否通過(guò) BOM 管理了版本有沒(méi)有某個(gè)依賴(lài)寫(xiě)了硬編碼版本導(dǎo)致沖突。大多數(shù)情況下這類(lèi)錯(cuò)誤都是因?yàn)槟硞€(gè)依賴(lài)的傳遞版本和主版本不匹配。尤其是在引入 Nacos 相關(guān)依賴(lài)時(shí)如果你沒(méi)走 SCA 的 BOM而是手動(dòng)引了nacos-client的某個(gè)版本就很容易出現(xiàn)com.alibaba.nacos.api.NacosFactory相關(guān)的NoClassDefFoundError。8. 項(xiàng)目實(shí)戰(zhàn)中的版本踩坑與排查思路完整鏈路復(fù)盤(pán)這一節(jié)是很多人最想看的內(nèi)容——踩坑實(shí)錄。我不打算把答案直接擺出來(lái)而是帶著你走一遍完整的排查鏈路這樣以后再遇到類(lèi)似的版本問(wèn)題你就知道該怎么查了。8.1 坑一Nacos 服務(wù)注冊(cè)報(bào) 401 錯(cuò)誤但賬號(hào)密碼能登錄控制臺(tái)這個(gè)坑出現(xiàn)的頻率非常高尤其在一些企業(yè)內(nèi)網(wǎng)環(huán)境里?，F(xiàn)象是Nacos 控制臺(tái)能用nacos/nacos登錄但項(xiàng)目啟動(dòng)時(shí)一直報(bào)401未授權(quán)日志里出現(xiàn)類(lèi)似[NA] Client is not authorized, context: /nacos/v1/ns/instance排查鏈路先確認(rèn) Nacos Server 的版本和鑒權(quán)配置。Nacos 從 2.2.1 開(kāi)始如果沒(méi)有配置自定義鑒權(quán)密鑰會(huì)默認(rèn)開(kāi)啟鑒權(quán)但行為在后續(xù)版本里也有調(diào)整。檢查application.yml或bootstrap.yml里的username和password是否配置以及有沒(méi)有拼寫(xiě)錯(cuò)誤。重點(diǎn)檢查spring.cloud.nacos.username和spring.cloud.nacos.password這兩個(gè)配置項(xiàng)是否放到了正確層級(jí)。有人會(huì)把它們寫(xiě)到discovery里其實(shí)寫(xiě)到cloud.nacos根層級(jí)下即可全局生效。如果都配置對(duì)了還報(bào) 401看一下 Nacos Server 的application.properties檢查nacos.core.auth.plugin.nacos.token.secret.key是否被修改過(guò)。有些公司會(huì)統(tǒng)一改這個(gè)密鑰但客戶(hù)端那邊不知道。我實(shí)際碰到過(guò)一個(gè)公司項(xiàng)目Nacos 控制臺(tái)可以登錄但服務(wù)注冊(cè)一直 401最后發(fā)現(xiàn)是兩個(gè) Nacos 環(huán)境代碼里的配置指向的是測(cè)試環(huán)境而控制臺(tái)登的是生產(chǎn)環(huán)境。這種環(huán)境串了的問(wèn)題排錯(cuò)時(shí)尤其容易忽略。8.2 坑二Nacos 1.x 升級(jí) 2.x 后服務(wù)列表顯示正常但調(diào)用失敗這個(gè)坑的發(fā)生背景通常是老項(xiàng)目從 Nacos 1.4.x 升級(jí)到 2.2.x服務(wù)列表看起來(lái)都注冊(cè)成功了但服務(wù)間調(diào)用時(shí)好時(shí)壞甚至直接失敗。排查鏈路第一步查看項(xiàng)目里引入的 Nacos Client 版本。很多老項(xiàng)目的 BOM 管理不嚴(yán)格nacos-client的版本被第三方庫(kù)鎖定在 1.x。第二步用mvn dependency:tree -Dincludescom.alibaba.nacos看依賴(lài)樹(shù)確認(rèn)是否同時(shí)存在 1.x 和 2.x 的nacos-client。兩個(gè)版本同時(shí)在 classpath 里會(huì)出現(xiàn)類(lèi)加載順序不可控的問(wèn)題。第三步如果同時(shí)存在通過(guò)exclusion排除掉舊的 1.x保留和 Server 大版本一致的 2.x。第四步檢查防火墻是否放行了 9848/9849 端口。Nacos 2.x 客戶(hù)端用 gRPC 與服務(wù)端通信只開(kāi) 8848 會(huì)導(dǎo)致注冊(cè)成功但后續(xù)心跳失敗。這個(gè)坑的經(jīng)典之處在于表面上所有模塊都注冊(cè)成功了但底層通信已經(jīng)出了問(wèn)題。這也解釋了為什么很多教程反復(fù)強(qiáng)調(diào) Nacos 2.x 要開(kāi) 9848 端口。8.3 坑三Spring Boot 版本太高導(dǎo)致 Nacos 配置加載為空springboot版本太高是熱搜詞之一這種現(xiàn)象在 Spring Boot 3.x 剛發(fā)布時(shí)特別常見(jiàn)。有人圖新鮮把項(xiàng)目升到 3.0結(jié)果 Nacos 配置中心一直拉取不到配置控制臺(tái)和日志都沒(méi)有報(bào)錯(cuò)。排查鏈路先確認(rèn) Spring Cloud 和 SCA 的版本是否支持這個(gè) Spring Boot 主版本。Spring Boot 3.0 必須配 Spring Cloud 2022.0.x如果用的是 2021.0.x配置加載機(jī)制完全不同。查看bootstrap.yml是否生效。Spring Boot 2.4 之后bootstrap.yml默認(rèn)不再自動(dòng)加載需要引入spring-cloud-starter-bootstrap依賴(lài)或者用spring.config.import方式導(dǎo)入。確認(rèn) Nacos Config 的 Data ID 是否匹配。Spring Boot 3.x 的配置加載順序和 2.x 有區(qū)別有時(shí)配置寫(xiě)對(duì)了但匹配的 Data ID 不對(duì)。開(kāi)啟 debug 日志看NacosPropertySourceLocator是否被調(diào)用。如果類(lèi)沒(méi)被加載說(shuō)明 starter 沒(méi)生效如果被調(diào)用了但拿不到配置再看返回結(jié)果。我自己的經(jīng)驗(yàn)是只要升級(jí) Spring Boot 大版本優(yōu)先去翻 Spring Cloud 官方文檔的版本對(duì)應(yīng)表別只改 Spring Boot 版本就啟動(dòng)否則很容易陷入上述排查深淵。9. 給自己一個(gè)順手的工具鏈版本檢查與依賴(lài)管理建議講完大道理和踩坑最后分享一點(diǎn)我長(zhǎng)期維護(hù)多個(gè) Spring Cloud 項(xiàng)目的實(shí)用建議這些都是常規(guī)文檔里不會(huì)專(zhuān)門(mén)寫(xiě)的內(nèi)容。9.1 用 mvn dependency:tree 快速定位版本沖突不管你是接手老項(xiàng)目還是新建項(xiàng)目第一件事都是在項(xiàng)目根目錄跑一遍mvn dependency:tree -Dverbose重點(diǎn)看有沒(méi)有同一個(gè) groupId/artifactId 出現(xiàn)多個(gè)版本。如果出現(xiàn)了BOM 管理沒(méi)有完全生效需要檢查 dependencyManagement 里有沒(méi)有正確 import 對(duì)應(yīng)的 BOM。這個(gè)命令是排查版本沖突的第一利器。有一個(gè)小技巧輸出結(jié)果太長(zhǎng)時(shí)加-Dincludescom.alibaba.cloud:spring-cloud-starter-alibaba-nacos-discovery之類(lèi)的過(guò)濾條件只看你關(guān)心的模塊。9.2 在 IDEA 里看依賴(lài)圖比命令行更直觀IntelliJ IDEA 的 Maven 面板里有個(gè)Show Dependencies功能會(huì)以圖形化方式展示所有依賴(lài)關(guān)系。出現(xiàn)版本沖突時(shí)紅色實(shí)線會(huì)非常顯眼。我一般會(huì)同時(shí)打開(kāi)pom.xml的 Dependency Analyzer它能直接列出沖突和重復(fù)的依賴(lài)。這對(duì)不熟悉命令行的同學(xué)尤其友好。9.3 關(guān)于 Nacos Server 部署的幾個(gè)版本建議開(kāi)發(fā)環(huán)境Docker 單機(jī)跑MODEstandalone內(nèi)存占用最小。我用 2G 內(nèi)存的云主機(jī)跑過(guò) Nacos 2.2.1完全沒(méi)問(wèn)題。測(cè)試/生產(chǎn)環(huán)境推薦集群部署至少 3 個(gè)節(jié)點(diǎn)配合 MySQL 存儲(chǔ)配置。Nacos 2.x 的集群還需要保證節(jié)點(diǎn)之間網(wǎng)絡(luò)互通并正確配置NACOS_SERVERS環(huán)境變量。鑒權(quán)務(wù)必開(kāi)啟生產(chǎn)環(huán)境不配置自定義鑒權(quán)密鑰等于把配置中心裸奔在網(wǎng)絡(luò)上。這個(gè)不是版本對(duì)應(yīng)問(wèn)題但和版本行為強(qiáng)相關(guān)。9.4 最后的版本決策思路如果你現(xiàn)在站在選型路口我會(huì)給你這樣的建議新項(xiàng)目、團(tuán)隊(duì)技術(shù)棧能接受 JDK 17選 Spring Boot 3.2.x Spring Cloud 2023.0.x SCA 2023.0.1.x Nacos 2.3.x。老項(xiàng)目、團(tuán)隊(duì)還停留在 JDK 8選 Spring Boot 2.6.x Spring Cloud 2021.0.x SCA 2021.0.5.0 Nacos 2.x。極端保守選 Spring Boot 2.3.x 全家桶網(wǎng)上資料最多但那已經(jīng)是 2021 年前的維護(hù)狀態(tài)了能不上就不上。版本管理這件事說(shuō)到底就是一句話不要自己創(chuàng)造組合跟著官方和社區(qū)驗(yàn)證過(guò)的組合走。如果你吃不準(zhǔn)用start.spring.io初始化項(xiàng)目時(shí)選好 Spring Boot 版本再用 Spring Cloud Alibaba 官方 Wiki 的版本對(duì)應(yīng)表核對(duì) SCA 版本基本不會(huì)出大問(wèn)題。我自己每次搭新項(xiàng)目時(shí)都會(huì)把選定的版本組合寫(xiě)進(jìn)團(tuán)隊(duì)的架構(gòu)文檔里避免后來(lái)的人隨手升級(jí)某個(gè)依賴(lài)導(dǎo)致整條鏈路崩掉。這種習(xí)慣看似瑣碎但真能幫你省掉大量排查時(shí)間。