Nacos持久化方案升级：从Derby到MySQL的实践指南

1. 为什么需要Nacos持久化方案升级

第一次在生产环境部署Nacos时，我直接使用了默认的嵌入式Derby数据库。当时觉得这个方案简单省事，连配置都不需要改就能跑起来。直到某个周一早晨，运维同事慌慌张张打电话说Nacos服务挂了，重启后所有配置数据全没了——那一刻我才真正理解到，嵌入式数据库在可靠性方面的致命缺陷。

Nacos默认的Derby嵌入式数据库存在几个明显短板：

• 数据可靠性低：服务进程崩溃可能导致数据文件损坏
• 不支持集群：单机部署无法满足高可用需求
• 性能瓶颈：配置量超过10万条时查询延迟明显上升
• 备份困难：需要停服才能进行完整数据备份

相比之下，MySQL作为成熟的关系型数据库：

• 支持主从架构，数据多副本存储
• 提供完善的备份恢复机制
• 具备优秀的读写性能（特别是索引优化后）
• 与Nacos集群模式完美配合

关键提示：即使你的Nacos目前只管理少量配置，也应该在初期就采用MySQL持久化。我见过太多团队在业务增长后被迫半夜迁移数据的案例。

2. 迁移前的环境准备与检查

2.1 MySQL环境配置要求

根据Nacos官方文档和生产经验，MySQL需要满足以下条件：

安装完成后需要执行：

sql复制# 创建数据库（注意字符集）
CREATE DATABASE nacos_config 
  CHARACTER SET utf8mb4 
  COLLATE utf8mb4_general_ci;

# 创建专用用户
CREATE USER 'nacos'@'%' IDENTIFIED BY 'Nacos@123';
GRANT ALL PRIVILEGES ON nacos_config.* TO 'nacos'@'%';

2.2 Nacos数据备份策略

迁移前必须完整备份现有数据，我推荐双保险方案：

1. 控制台导出（适合配置量少的情况）：

   • 进入Nacos控制台
   • 配置管理 → 导出全部配置
   • 会生成一个压缩包包含所有命名空间的配置

2. 数据库级备份（必须操作）：

   bash复制# Derby数据库备份
   cp -r ${nacos.home}/data/derby-data ${backup.path}
   
   # 如果使用内置Derby
   shutdown=true
   

血泪教训：曾经有团队只做了控制台导出，迁移后发现部分历史版本配置丢失。一定要同时做数据库文件备份！

3. 分步迁移实操指南

3.1 修改Nacos持久化配置

找到Nacos的application.properties文件（通常在conf目录下），关键修改点：

properties复制# 启用MySQL数据源
spring.datasource.platform=mysql

# 数据库连接数建议按核心数×2配置
db.num=8
db.url.0=jdbc:mysql://mysql-primary:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000
db.user.0=nacos
db.password.0=Nacos@123

# 集群环境下配置多个节点
db.url.1=jdbc:mysql://mysql-secondary:3306/nacos_config
db.user.1=nacos
db.password.1=Nacos@123

特别注意：

• 密码中包含特殊字符时需要URL编码
• 生产环境建议配置连接池参数：

  properties复制db.pool.config.connectionTimeout=3000
  db.pool.config.validationTimeout=1000
  db.pool.config.maximumPoolSize=20
  

3.2 初始化MySQL数据库

Nacos提供了官方SQL脚本，位置在：
${nacos.home}/conf/nacos-mysql.sql

执行时常见问题处理：

sql复制-- 如果遇到GTID报错需要添加（MySQL 5.7+）
SET @@GLOBAL.ENFORCE_GTID_CONSISTENCY = OFF;

-- 表已存在错误处理
DROP TABLE IF EXISTS config_info;

3.3 数据迁移的两种方案

方案一：双写模式（推荐）

1. 保持旧Nacos继续运行
2. 新部署Nacos实例连接MySQL
3. 使用API同步数据：

   bash复制# 从旧实例获取配置
   curl -X GET "http://old-nacos:8848/nacos/v1/cs/configs?dataId=example&group=DEFAULT_GROUP"
   
   # 写入新实例
   curl -X POST "http://new-nacos:8848/nacos/v1/cs/configs" -d "dataId=example&group=DEFAULT_GROUP&content=..."
   

方案二：数据库导入

1. 使用mysqldump导出Derby数据（需安装JDBC驱动）

   bash复制java -jar derby-tools.jar export --connect=jdbc:derby:${nacos.home}/data/derby-data --table=config_info --output=config_info.csv
   

2. 使用MySQL的LOAD DATA命令导入

   sql复制LOAD DATA LOCAL INFILE 'config_info.csv' 
   INTO TABLE nacos_config.config_info 
   FIELDS TERMINATED BY ',';
   

性能对比：实测10万条配置数据，双写模式约需30分钟，数据库导入约8分钟但风险较高。

4. 迁移后的验证与优化

4.1 基础功能验证清单

1. 配置读写测试：

   java复制// 写入测试
   ConfigService configService = NacosFactory.createConfigService("127.0.0.1:8848");
   configService.publishConfig("test-data", "DEFAULT_GROUP", "content");
   
   // 读取验证
   String content = configService.getConfig("test-data", "DEFAULT_GROUP", 5000);
   

2. 监听功能验证：

   java复制configService.addListener("test-data", "DEFAULT_GROUP", new AbstractListener() {
       @Override
       public void receiveConfigInfo(String configInfo) {
           System.out.println("Config changed: " + configInfo);
       }
   });
   

4.2 MySQL性能优化建议

1. 索引优化（在百万级配置量下效果显著）：

   sql复制ALTER TABLE config_info ADD INDEX idx_group_id (group_id);
   ALTER TABLE his_config_info ADD INDEX idx_dataId (data_id);
   

2. 分区表策略（超大规模部署适用）：

   sql复制ALTER TABLE config_info PARTITION BY KEY(group_id) PARTITIONS 16;
   

3. 连接池监控指标：

   properties复制# 开启Druid监控
   db.pool.config.filter.stat.enabled=true
   db.pool.config.filter.stat.logSlowSql=true
   

4.3 常见故障处理

问题一：启动时报No DataSource set

• 检查项：
  1. 确认spring.datasource.platform=mysql未拼写错误
  2. 检查MySQL驱动包是否存在（nacos/lib目录下应有mysql-connector-java-8.0.x.jar）

问题二：控制台能打开但无法读取配置

• 排查步骤：
  1. 检查Nacos日志中是否有JDBC异常
  2. 手动连接MySQL验证权限
  3. 查看config_info表数据是否完整

问题三：写入性能下降

• 优化方案：
  1. 增加db.num值（建议不超过CPU核心数×2）
  2. 调整MySQL的innodb_buffer_pool_size（建议设为物理内存的70%）
  3. 检查是否有未提交的长事务

5. 生产环境进阶建议

5.1 高可用架构设计

对于核心业务系统，建议采用以下架构：

code复制                        +-----------------+
                        |   SLB/Ingress   |
                        +--------+--------+
                                 |
           +---------------------+---------------------+
           |                     |                     |
+----------+----------+ +--------+--------+ +----------+----------+
|  Nacos Server 1     | | Nacos Server 2  | | Nacos Server 3      |
| (MySQL Master)      | | (MySQL Slave)   | | (MySQL Slave)       |
+---------------------+ +-----------------+ +---------------------+

关键配置：

properties复制# 开启集群模式
nacos.standalone=false

# 配置集群节点信息
nacos.member.list=192.168.1.101:8848,192.168.1.102:8848,192.168.1.103:8848

5.2 监控指标配置

推荐监控项及阈值：

Grafana仪表板配置示例：

json复制{
  "panels": [{
    "title": "Nacos MySQL连接池",
    "targets": [{
      "expr": "nacos_connection_active{instance=~\"$instance\"}",
      "legendFormat": "{{instance}} 活跃连接"
    }]
  }]
}

5.3 数据清理策略

通过以下SQL创建定时清理任务：

sql复制-- 保留最近30天的历史版本
CREATE EVENT purge_history
ON SCHEDULE EVERY 1 DAY
DO
  DELETE FROM his_config_info 
  WHERE gmt_modified < DATE_SUB(NOW(), INTERVAL 30 DAY);

-- 清理无效监听者
CREATE EVENT purge_listeners
ON SCHEDULE EVERY 6 HOUR
DO
  DELETE FROM config_listener 
  WHERE md5 IS NULL OR md5 = '';

在Nacos 2.2.0+版本中，可以直接使用内置清理功能：

properties复制# 开启自动清理
nacos.config.clean.enabled=true
# 保留天数
nacos.config.clean.keep.days=30
# 批次大小
nacos.config.clean.batch.size=1000

迁移到MySQL后，Nacos的运维复杂度确实有所增加，但带来的数据可靠性和扩展性提升绝对值得。最近我们一个业务高峰期，Nacos单日配置变更达到12万次，MySQL表现依然稳定。建议在迁移完成后，立即配置完整的监控和报警规则，这对后续的稳定性保障至关重要。