哈喽，大家好！我是你们的技术伙伴小米，今天想和大家分享一个近期团队中的实战经验。背景是这样的：由于Nacos 1.3.0 版本频频出现安全漏洞，我们决定将其升级到2.3.0。这个过程中，既有平稳过渡的时刻，也踩了一些“隐形坑”，特别是其中一个“空格杀手”，让我有点崩溃。
如果你正在考虑升级Nacos，或者想了解一下升级过程中的注意事项，那么这篇文章一定对你有所帮助！我们会从以下几个方面来讲：
- 单机Nacos升级步骤
- 单机Nacos升级注意事项
- 集群Nacos升级步骤（三台服务器）
- 集群Nacos升级注意事项
- 一次特别的“空格”事件及解决方法
单机Nacos的升级步骤
首先，我们来看看如何将Nacos单机从1.3.0升级到2.3.0。具体步骤如下：
1. 下载最新的Nacos安装包
去Nacos的官方GitHub仓库下载2.3.0版本的安装包。你可以根据需要选择ZIP或TAR包形式。
2. 备份现有数据
在进行任何升级操作之前，务必备份现有Nacos的数据，尤其是nacos/conf目录下的配置信息。你可以通过将整个Nacos目录复制到另一个位置来完成这个备份操作，以防不测。
3. 停止当前的Nacos服务
在你运行Nacos的服务器上，通过以下命令停止服务：
- sh shutdown.sh
确保Nacos已经完全停止后，再进行下一步操作。
4. 替换Nacos文件
删除旧的Nacos 1.3.0版本，并将刚刚下载的2.3.0版本解压到相应的目录。
5. 配置数据迁移
如果你使用了MySQL数据库进行数据存储，别忘了查看新的Nacos版本是否有数据库结构变化。通常，2.x版本相对于1.x会有部分结构调整，所以需要在升级前运行对应的SQL脚本。可以在nacos/distribution/conf/nacos-mysql.sql目录中找到相应的SQL文件。
6. 启动Nacos
一切准备就绪后，使用以下命令启动新的Nacos服务：
- sh startup.sh -m standalone
然后访问Nacos控制台，检查服务是否正常启动。
单机Nacos升级注意事项
- 数据库备份：对于使用MySQL存储配置的用户，千万不要忘记先备份数据库。SQL表结构可能会有变化，确保在运行升级脚本前备份好原始数据。
- JDK版本检查：Nacos 2.x需要的JDK版本是1.8或更高，升级前务必确保JDK版本满足要求。
- 检查配置文件差异：尽管Nacos会保留一些默认配置，但升级可能引入新的配置项。建议对比原有的application.properties与新版本中的默认配置，避免遗漏重要配置项。
集群Nacos的升级步骤
接下来，我们讲一下集群模式下Nacos的升级步骤。我们团队是三台服务器的集群，因此以三台集群为例。
1. 依次停掉Nacos服务
集群模式下升级不能一刀切，避免造成配置中心不可用。可以逐台停止服务，执行以下命令来停止Nacos服务：
- sh shutdown.sh
依次在三台机器上执行，建议每次停一台，剩余两台服务依然能够维持集群的运行。
2. 升级操作与单机类似
停掉的那台机器进行和单机模式相同的升级操作。包括下载新版本、解压替换文件、运行数据库迁移脚本等。
3. 启动第一台服务器
升级完成后，启动这台服务器：
- sh startup.sh -m cluster
等待Nacos服务启动成功后，再进行下一台服务器的升级。
4. 逐步升级其他服务器
重复上述操作，逐台升级并启动其余两台服务器。确保整个过程中集群不会同时停止，以免影响服务的可用性。
5. 检查集群状态
当三台服务器都完成升级并启动后，进入Nacos控制台，查看各个节点是否正常加入集群。你可以通过点击“集群管理”页面，检查所有节点的运行状态。
集群Nacos升级注意事项
- 逐台升级，保持服务可用：切记不要一次性停掉所有的Nacos节点。升级过程中要保持集群中至少一台机器在运行，确保配置管理和服务注册不受影响。
- 版本兼容性测试：在实际操作之前，建议先搭建一个测试环境，验证新旧版本的兼容性，确保所有微服务可以在2.3.0版本下正常运行。
- 数据库一致性：集群升级时，最好先将Nacos的数据库从1.3.0迁移到2.3.0所需的结构。检查是否有新的数据库字段或表。
- 日志清理：Nacos生成的日志文件会在集群节点上占用大量空间，升级前可以定期清理旧日志，避免日志膨胀影响磁盘空间。
“空格”杀手——集群微服务启动问题
在升级过程中，发生了一个非常令人抓狂的“空格”事件。
事件描述：
我们升级完Nacos集群后，发现有一台服务器上的某个微服务始终无法启动，报错信息一直是“user not found！”，但其他服务器上的同一个微服务却正常启动。经过一系列排查后，问题逐步锁定在Nacos配置上。
排查过程：
- 账号登录检查：首先，我们使用新配置的账号密码登录Nacos管理平台，一切正常，证明权限设置没有问题。
- 微服务Jar包对比：我们还对比了微服务的Jar包，确保所有服务器上的微服务包是一致的。
- 网络连接检查：接着，我们去观察网络是否存在延迟或阻塞，但网络情况也是一切正常。
- 配置文件对比：最后，我们使用了配置对比工具，终于发现了问题！出问题的服务器上application.properties文件中的username配置后面多了一个空格，导致Nacos无法识别正确的账号。
问题解决：
我们立马去掉了这个多余的空格，重启微服务，问题解决！简直是个“大意失荆州”的案例！
教训总结：
在配置文件中，空格是极难察觉的，特别是在不易发现的地方。下次遇到类似问题，建议大家在排查时，务必对比配置文件中的每个字符，尤其是无关紧要的空格。
END
这次Nacos升级从1.3.0到2.3.0，虽然整体升级过程还算顺利，但细节问题往往是最容易忽略的。这次的“空格”问题给我们提了个醒——配置文件中的每个字符都可能成为系统的致命伤。
希望大家在今后的工作中能少踩坑，提升效率！如果你也遇到了类似的升级问题，欢迎留言分享！我们一起学习、一起进步~
我是小米，一个喜欢分享技术的29岁程序员。如果你喜欢我的文章，欢迎关注我的微信公众号“软件求生”，获取更多技术干货！
