如何迁移含RedisGraph模块的Redis RDB至Redis Stack 7.2+环境？

问题原因 #

Redis Stack 7.2版本正式移除了RedisGraph模块，而旧版本（如6.2.13）生成的RDB文件中会包含graphdata模块的AUX元数据——哪怕你从未使用过图功能，7.2版本加载时也会因找不到对应模块而报错：

• Loading RDB produced by version 6.2.13
• RDB age 848231 seconds
• RDB memory usage when created 1.50 Mb

The RDB file contains AUX module data I can't load: no matching module 'graphdata' #

迁移解决方案 #

方法一：通过旧版本清理RDB中的模块数据

1. 启动你原来使用的旧版本Redis Stack（如6.2.13），确保能正常加载目标RDB文件
2. 执行命令卸载RedisGraph模块：

   MODULE UNLOAD graph
   

3. 重新生成不含graphdata的RDB文件：

   # 同步保存（会阻塞实例，适合小型数据集）
   SAVE
   # 或异步保存（不阻塞实例，适合大型数据集）
   BGSAVE
   

4. 停止旧版本实例，启动Redis Stack 7.2，加载新生成的RDB文件即可正常运行

方法二：用数据迁移工具同步到7.2实例

如果不想启动旧版本实例，可以用redis-shake这类轻量工具完成全量数据迁移：

1. 下载对应平台的redis-shake二进制包
2. 编写同步配置文件（示例）：

   source:
     address: 旧Redis实例地址:端口
     password: 旧实例密码（如有）
   target:
     address: Redis Stack 7.2实例地址:端口
     password: 7.2实例密码（如有）
   shake_type: fullsync
   

3. 启动redis-shake完成全量同步，同步完成后7.2实例会拥有所有数据，且不会携带graphdata模块信息
4. 可在7.2实例执行SAVE命令生成兼容的新RDB文件

注意事项 #

• 操作前务必备份原RDB文件，避免数据丢失
• 若使用Docker部署，需确保旧版本容器能正确挂载原RDB目录
• Redis Stack 7.2的其他核心模块（如Search、JSON、TimeSeries等）仍保持向下兼容，仅需清理graphdata模块元数据即可正常使用

内容的提问来源于stack exchange，提问作者goose_lake