使用 Nacos 的注意事项与最佳实践

📹 背景

Nacos 凭借其强大💪的服务发现、配置管理和服务管理能力，成为构建分布式系统的得力助手。然而，要充分发挥 Nacos 的优势，实现系统的高性能、高可用，掌握其使用过程中的注意事项和最佳实践至关重要。接下来，我们将深入探讨相关要点。

🧠 学习相关要点

这篇文章我们将探讨 Nacos 的注意事项与最佳实践🚨，我们希望达成以下具体的目标：

✅ 性能优化策略。
✅ 高可用部署方案。
✅ 常见问题解决方案。

一、性能优化策略

1️⃣ 合理设置心跳间隔

Nacos 依赖心跳机制来实时监测服务实例的健康状况，而心跳间隔的精准设置对系统性能有着直接且关键的影响🙀。我们可通过如下方式进行配置例子

@Bean
public NamingService namingService() throws NacosException {Properties properties = new Properties();properties.setProperty("serverAddr", "127.0.0.1:8848");// 将心跳间隔设为10秒properties.setProperty("heartBeatInterval", "10000");return NamingFactory.createNamingService(properties);
}

在实际应用场景中，若系统对稳定性要求极高，例如金融交易系统，建议将心跳间隔设置在 10 - 15 秒，以减少因网络波动等因素导致的误判，确保服务状态的稳定监测。对于那些对状态变化极为敏感的系统，像实时数据分析系统，可适当缩短心跳间隔至 5 - 10 秒，以便及时捕捉服务状态的动态变化。而在大型集群环境下，为降低网络请求压力，可考虑启用批量心跳上报功能，减少客户端与服务端之间的交互次数。

2️⃣ 优化缓存策略

Nacos 客户端为我们提供了配置缓存功能，通过合理设置缓存过期时间，能显著减少对远程配置的频繁请求。以下是 Java 客户端中设置缓存过期时间的示例：

@Bean
public ConfigService configService() throws NacosException {Properties properties = new Properties();properties.setProperty("serverAddr", "127.0.0.1:8848");// 将配置缓存过期时间设为5分钟properties.setProperty("configCacheTime", "300000");return ConfigFactory.createConfigService(properties);
}

为进一步提升缓存性能💪，可构建多级缓存体系。以自定义本地缓存为例，借ConcurrentHashMap实现快速读写，并添加精细的过期检查逻辑。当本地缓存中存在未过期的配置时，直接返回，避免不必要的远程请求😃；若缓存过期或不存在，则从 Nacos 服务器中获取最新配置并更新本地缓存。代码例子如下

import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;public class NacosConfigCache {// 配置项缓存private static final Map<String, String> CONFIG_CACHE = new ConcurrentHashMap<>();// 缓存时间戳，记录每个配置项的最后更新时间private static final Map<String, Long> CACHE_TIMESTAMP = new ConcurrentHashMap<>();// 默认缓存过期时间5分钟（300000毫秒）private static final long DEFAULT_CACHE_EXPIRE_TIME = 300000;/*** 获取配置项* @param dataId 配置ID* @return 配置值*/public static String getConfig(String dataId) {return getConfig(dataId, DEFAULT_CACHE_EXPIRE_TIME);}/*** 获取配置项（带自定义过期时间）* @param dataId 配置ID* @param expireTime 自定义过期时间（毫秒）* @return 配置值*/public static String getConfig(String dataId, long expireTime) {String cachedValue = CONFIG_CACHE.get(dataId);if (cachedValue != null && !isExpired(dataId, expireTime)) {return cachedValue;}// 从Nacos服务器获取最新配置String newValue = fetchFromNacos(dataId);if (newValue != null) {updateCache(dataId, newValue);}return newValue;}/*** 检查缓存是否过期* @param dataId 配置ID* @param expireTime 过期时间（毫秒）* @return true表示已过期，false表示未过期*/private static boolean isExpired(String dataId, long expireTime) {Long lastUpdateTime = CACHE_TIMESTAMP.get(dataId);if (lastUpdateTime == null) {return true;}long currentTime = System.currentTimeMillis();return (currentTime - lastUpdateTime) > expireTime;}/*** 更新缓存* @param dataId 配置ID* @param value 配置值*/private static void updateCache(String dataId, String value) {long currentTime = System.currentTimeMillis();CONFIG_CACHE.put(dataId, value);CACHE_TIMESTAMP.put(dataId, currentTime);}/*** 模拟从Nacos服务器获取配置* @param dataId 配置ID* @return 配置值*/private static String fetchFromNacos(String dataId) {// 这里应该是实际的Nacos客户端调用// 示例中返回模拟值System.out.println("Fetching fresh config from Nacos for: " + dataId);return "value_for_" + dataId;}/*** 清除指定配置项的缓存* @param dataId 配置ID*/public static void clearCache(String dataId) {CONFIG_CACHE.remove(dataId);CACHE_TIMESTAMP.remove(dataId);}/*** 清除所有缓存*/public static void clearAllCache() {CONFIG_CACHE.clear();CACHE_TIMESTAMP.clear();}
}

3️⃣ JVM 参数优化

Nacos 服务器基于 Java 运行，合理调整 JVM 参数能有效提升其性能表现。以下是推荐的 Nacos 服务器启动参数配置：

# 设置初始堆内存和最大堆内存
JAVA_OPT="${JAVA_OPT} -Xms2g -Xmx2g"
# 使用G1垃圾回收器
JAVA_OPT="${JAVA_OPT} -XX:+UseG1GC"
# 设置并行GC线程数
JAVA_OPT="${JAVA_OPT} -XX:ParallelGCThreads=4"
# 设置最大GC暂停时间目标
JAVA_OPT="${JAVA_OPT} -XX:MaxGCPauseMillis=100"

二、高可用部署方案

集群部署架构：为避免单点故障，提升系统可用性，Nacos 通常采用集群部署架构。典型的集群架构如下：

    [负载均衡器]/    |    \
[Nacos节点1] [Nacos节点2] [Nacos节点3]|      |      |
[MySQL主库] ←→ [MySQL从库]

1️⃣ 集群节点配置

在Nacos的conf目录下，需要配置cluster.conf文件，列出所有集群节点信息


192.168.1.101:8848
192.168.1.102:8848
192.168.1.103:8848

关键点：

至少需要3个Nacos节点才能构成集群。
各节点server-id必须唯一。
生产环境建议将Nacos节点部署在不同物理机上。

2️⃣ 负载均衡配置

前端通过负载均衡器（如 Nginx 或云厂商提供的负载均衡服务）将请求均匀分发至各个 Nacos 节点，并配置健康检查机制，确保后端节点出现故障时能及时将流量切换至健康节点。以下呢，是一个例子：

upstream nacos {server 192.168.1.101:8848;server 192.168.1.102:8848;server 192.168.1.103:8848;
}server {listen 80;server_name nacos.example.com;location / {proxy_pass http://nacos;}
}

3️⃣ 数据存储高可用配置

以 MySQL 数据库为例，在application.properties文件中可进行如下配置。

# 使用MySQL作为持久化存储
spring.datasource.platform=mysql
# 数据库数量
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
db.user=nacos
db.password=nacos@123

为保障数据库的高可用性，应配置 MySQL 主从复制，实现数据冗余备份和读写分离。合理设置数据库连接池参数，提升数据库连接的复用率和性能。定期执行数据库维护操作，包括优化表结构、定期备份数据等，以确保数据库的稳定运行和数据安全。

4️⃣ 客户端集群配置

Java客户端配置如下：

@Bean
public NamingService namingService() throws NacosException {Properties properties = new Properties();// 配置多个Nacos服务器地址properties.setProperty("serverAddr", "192.168.1.101:8848,192.168.1.102:8848,192.168.1.103:8848");// 开启集群容错properties.setProperty("namingLoadCacheAtStart", "true");return NamingFactory.createNamingService(properties);
}

通过配置多个 Nacos 服务器地址，客户端在请求服务时可自动进行故障转移，提高服务发现的可靠性。开启namingLoadCacheAtStart属性，可使客户端在启动时加载缓存，避免首次请求服务时的延迟。此外，还可根据实际业务需求，在 Nacos 控制台为不同的服务实例设置权重等。

三、💥 常见问题解决方案

✔️ 服务注册延迟问题

当遇到服务注册延迟问题时，可按以下步骤进行排查：

☑️ 首先，检查心跳间隔设置是否合理，若心跳间隔过长，可能导致服务注册延迟。
☑️ 其次，确认网络延迟情况，网络不稳定或延迟过高会影响服务注册的时效性。
☑️ 最后，检查 Nacos 服务器负载，若服务器负载过高，可能会导致服务注册请求处理缓慢。
☑️ 在代码层面，可通过设置获取服务实例的超时时间，优化服务注册逻辑，示例如下：

// 获取服务实例时设置超时时间为3秒
List<Instance> instances = namingService.getAllInstances("service-name", Arrays.asList("group-name"), true, 3000  
);

✔️ 配置中心同步问题

☑️ 采取增加配置监听器的方式，实时监听配置变更，一旦配置发生变化，及时进行处理。
☑️ 同时，实现本地缓存降级策略，当配置中心出现故障或同步延迟时，可暂时使用本地缓存中的配置，保障业务的连续性。

示例如下：

configService.addListener("dataId", "group", new Listener() {@Overridepublic void receiveConfigInfo(String configInfo) {// 在此处理配置变更refreshConfiguration(configInfo);}@Overridepublic Executor getExecutor() {return null;}
});