Nacos从2.0.4升级到2.4.3的完整步骤及注意事项

⚙️ 一、升级前准备

1. 环境检查

   • JDK版本：确保JDK≥1.8（推荐JDK 11+），执行 java -version 验证[citation:2][citation:4]。
   • 端口开放：2.0+版本需开放9848端口（gRPC通信），而1.x仅需8848端口[citation:8]。
   • 数据库兼容性：若使用MySQL，需≥5.7版本，并备份所有Nacos相关数据[citation:2][citation:6]。

2. 关键备份操作

   # 备份配置和数据
   cp -r /path/to/nacos/conf /backup/nacos_conf_2.0.4
   tar -czvf nacos_data_backup.tar.gz /path/to/nacos/data
   # MySQL备份（若使用）
   mysqldump -u root -p nacos_db > nacos_db_backup.sql
   

   注：配置文件重点备份 application.properties 和 cluster.conf（集群模式）[citation:1][citation:7]。

---

二、升级步骤

1. 停止Nacos服务

   cd /path/to/nacos/bin
   sh shutdown.sh  # 确保进程完全终止[citation:1]
   

2. 下载并解压新版本

   wget https://github.com/alibaba/nacos/releases/download/2.4.3/nacos-server-2.4.3.zip
   unzip nacos-server-2.4.3.zip -d /opt/nacos-2.4.3
   

3. 迁移配置与数据

   • 复制旧版配置到新目录：

     rsync -avh /backup/nacos_conf_2.0.4/* /opt/nacos-2.4.3/conf/
     

   • 检查配置文件差异：对比新旧版 application.properties，重点调整：
     • 新增鉴权配置（如 nacos.core.auth.enabled=true）[citation:2]。
     • 数据库连接参数（确保无多余空格⚠️ [citation:7]）。

4. 数据库结构更新（如需）

   • 执行新版SQL脚本（位于 nacos-2.4.3/conf/mysql-schema.sql），仅需运行新增的DDL语句[citation:6][citation:7]。

5. 启动新版本

   cd /opt/nacos-2.4.3/bin
   # 单机模式
   sh startup.sh -m standalone
   # 集群模式
   sh startup.sh -m cluster
   

---

⚠️ 三、版本差异注意事项

1. 协议与端口变更

   • 2.4.3默认使用 gRPC协议（9848端口），需确保防火墙开放此端口[citation:8]。
   • 客户端需同步升级至2.x版本，否则无法连接[citation:6][citation:8]。

2. 安全增强

   • 2.4.3强制开启鉴权，需在 application.properties 配置密钥：

     nacos.core.auth.enabled=true
     nacos.core.auth.server.identity.key=your_key
     nacos.core.auth.server.identity.value=your_value
     

     密钥需为32字符以上的Base64编码字符串[citation:2][citation:4]。

3. 集群升级策略

   • 逐台升级：每次只停一台节点，确保集群可用性[citation:7]。
   • 升级后检查节点状态：登录控制台 → 集群管理 → 节点列表，确认所有节点健康[citation:7]。

---

四、验证与回滚

1. 验证方法

   • 访问控制台：http://:8848/nacos（默认账号 nacos/nacos）。
   • 检查服务注册：

     curl http://localhost:8848/nacos/v1/ns/service/list
     

   • 客户端测试：确保微服务能正常注册/获取配置[citation:1]。

2. 回滚方案

   • 若升级失败：
     ① 停止新版本服务。
     ② 还原备份的配置和数据文件。
     ③ 重启旧版本Nacos[citation:6]。

---

五、常见问题解决

• 启动失败：检查 logs/start.out 日志，常见问题包括：
  • JDK版本不符（需≥1.8）[citation:2]。
  • 端口冲突（确保8848/9848未被占用）[citation:4]。
• 客户端连接异常：检查客户端版本是否≥2.0.4，并确认9848端口通信正常[citation:8]。
• 空格陷阱：配置文件中的多余空格（如 username = nacos␣）会导致认证失败，建议用工具对比配置[citation:7]。