如何优化 Nacos MySQL 持久化配置避免大数据量写入瓶颈

核心结论：当 Nacos 配置项超过 1000 条时，默认 Derby 存储性能会显著下降，切换至 MySQL 并优化连接池配置可支撑超过 100 万条配置的稳定运行。

原因分析

Nacos 默认使用内嵌的 Apache Derby 数据库存储配置数据，该方案存在明确的性能边界。根据技术对比数据，Derby 的最大连接数约为 50，而 MySQL 取决于配置通常可达 100+ 连接。当配置项数量超过 1000 条时，Derby 的查询性能会显著下降，且适合的数据规模上限为 10 万条配置，而 MySQL 可支撑超过 100 万条配置。

性能瓶颈主要出现在三个场景：数据库查询效率方面，ConfigInfoMapperByMySql.java 中的 SQL 查询模式直接影响响应速度；线程资源竞争方面，Raft 协议相关的核心线程配置 (nacos.core.protocol.raft.data.core_thread_num) 默认值为 8，在高并发场景下容易成为瓶颈；网络连接管理方面，Grpc 连接状态监听回调频繁触发会消耗大量资源。

解决方案

1. 数据库连接池优化

调整 HikariCP 连接池参数是提升写入性能的关键步骤。在 application.properties 配置文件中添加以下参数：

spring.datasource.hikari.maximum-pool-size=50
spring.datasource.hikari.minimum-idle=10
spring.datasource.hikari.connection-timeout=30000

根据 Nacos 性能调优指南，默认连接池大小需要根据实际并发量调整，生产环境建议将最大连接池大小设置为 50-100 之间。

2. Raft 协议线程调优

针对集群模式下的数据一致性问题，合理配置 Raft 协议参数可显著提升性能。在 nacos.conf 中添加：

nacos.core.protocol.raft.data.core_thread_num=16（默认 8）
nacos.core.protocol.raft.data.cli_service_thread_num=8（默认 4）
nacos.core.protocol.raft.data.election_timeout_ms=3000（默认 5000ms）

注意：单机模式 (MODE=standalone) 下 Raft 协议相关配置影响较小，集群模式必须调整。

3. 配置推送策略优化

减少配置推送重试次数可降低服务器负载。修改参数：

nacos.config.push.maxRetryTime=30（默认 50 次重试）
nacos.config.fuzzy.watch.max.pattern.count=20（默认 20 个匹配模式）

通过 CacheData 类中的线程阻塞控制可进一步优化配置拉取性能。

4. SQL 查询模式优化

参考 Nacos 源码中的优化实践，ConfigInfoMapperByMySql.java 采用"先 LIMIT 再 JOIN"的查询模式。在自定义查询场景中，避免全表扫描，使用索引优化查询语句。

注意事项

1. 版本兼容性：Nacos 2.x 版本需要 JDK 1.8 或更高版本，推荐使用 JDK 8 或 JDK 11。截至 2026 年，nacos/nacos-server:v2.2.3 和 v2.3.2 是经过广泛验证的稳定版本。

2. MySQL 版本选择：需要使用 MySQL 5.7 或 8.0 版本，实测 MySQL 8.0 完全兼容。使用 Docker 部署时，注意端口映射需包含 8848、9848 和 9849 三个端口。

3. 目录权限问题：使用 Docker 部署时，/mydata/nacos/logs/和/mydata/nacos/conf/目录需要正确的挂载权限，否则会导致配置文件无法读取。

4. 网络防火墙：确保宿主机防火墙规则允许访问 Nacos 相关端口 (8848, 9848 和 9849)，否则客户端无法连接。

5. 数据初始化：在 MySQL 中需先创建数据库 (如 nacos-config)，然后从 Nacos GitHub 仓库执行创建表结构的 SQL 脚本，否则启动会报错。

参考来源

来源：阿里云开发者社区 - Docker 单机部署 Nacos 并配置 MySQL 实现数据持久化

来源：Nacos 性能调优终极指南 - 从瓶颈诊断到高效优化（2026 年 3 月 27 日）

来源：告别 Derby-手把手教你将 Docker 版 Nacos 数据持久化到本地 MySQL（2026 年 4 月 30 日）

来源：Nacos - 基于 MySQL 的持久化配置最佳实践（2026 年 1 月 9 日）