Tube Archivist 项目中 RedisJSON 版本不兼容问题解析

问题背景

在 Tube Archivist 项目中，RedisJSON 是一个关键组件，用于处理 JSON 数据存储。近期有用户报告在 Unraid 系统上更新 RedisJSON 后出现服务无法启动的问题，这实际上是一个已知的版本兼容性问题。

问题现象

从日志中可以清晰地看到错误信息："Can't handle RDB format version 11" 和 "Fatal error loading the DB: Invalid argument"。这表明 Redis 服务无法处理当前的数据格式版本。

根本原因分析

这个问题源于 Redis 版本与 RedisJSON 模块版本之间的不匹配：

1. 用户环境中运行的 Redis 版本为 6.2.10
2. 但数据库文件(RDB)使用的是版本11的格式
3. 版本11的RDB格式是Redis 7.x引入的新特性
4. 当Redis 6.x尝试加载Redis 7.x创建的数据库文件时，就会出现这种不兼容错误

解决方案

针对这个问题，有两种可行的解决方案：

方案一：升级RedisJSON版本

将RedisJSON容器配置中的镜像标签从默认的latest改为redislabs/rejson:2.6.9。这个版本与Redis 7.x兼容，可以正确处理版本11的RDB格式。

方案二：重建数据库

如果无法立即升级RedisJSON，可以考虑：

1. 备份现有数据
2. 删除旧的数据库文件
3. 让RedisJSON重新创建新的数据库

预防措施

为避免类似问题再次发生，建议：

1. 在更新关键组件前，先检查版本兼容性
2. 避免使用latest标签，而是明确指定版本号
3. 定期备份重要数据
4. 在测试环境中先验证更新操作

技术细节

Redis的RDB(Redis Database)格式会随着主版本更新而变化。Redis 7.x引入了版本11的RDB格式，而Redis 6.x最高只支持到版本9。这种版本间的格式不兼容是设计上的有意为之，目的是确保数据结构的稳定性和性能优化。

对于Tube Archivist用户来说，保持RedisJSON与Redis版本的匹配至关重要，因为Tube Archivist重度依赖RedisJSON来处理视频元数据等结构化信息。