Laravel+Predis实现Redis树形结构存储及问题排查

一、树形结构存储方法 #

Redis本身是键值型数据库，原生没有树形结构，但可以通过以下两种方式模拟实现：

1. JSON序列化存储（适合整体读写树形数据） #

serialize()生成的是二进制序列化字符串，多数可视化工具无法解析成树形结构，改用json_encode()存储JSON格式字符串：

// 存储树形数据
$data = [
    'id' => 1,
    'name' => '张三',
    'profile' => [
        'age' => 28,
        'address' => [
            'city' => '上海',
            'district' => '浦东新区'
        ]
    ]
];
Redis::set('user:1', json_encode($data));

// 读取并还原树形结构
$treeData = json_decode(Redis::get('user:1'), true);

这种方式把整个树形结构作为单个键值存储，读写效率高，且JSON格式能被多数工具解析展示成树形。

2. 键命名空间拆分（适合单独操作子节点） #

通过键名的层级分隔（比如用冒号:）模拟树形结构，每个子节点对应独立的键：

// 拆分存储树形节点
Redis::set('user:1:id', 1);
Redis::set('user:1:name', '张三');
Redis::set('user:1:profile:age', 28);
Redis::set('user:1:profile:address:city', '上海');

// 读取单个子节点
$city = Redis::get('user:1:profile:address:city');

如果用哈希存储，嵌套字段必须转成字符串（比如JSON序列化），避免「Array to string conversion」错误：

$data = [
    'name' => '张三',
    'profile' => json_encode(['age' => 28, 'address' => ['city' => '上海']])
];
Redis::hmset('user:1', $data);

// 读取并解析嵌套字段
$profile = json_decode(Redis::hget('user:1', 'profile'), true);

二、树形结构查看工具 #

1. phpRedisAdmin #

• 若使用JSON序列化存储，确保工具版本支持JSON解析，会自动将JSON字符串展开为树形结构。
• 若使用键命名空间，在工具设置中开启「键分组」功能，会按冒号分隔的层级折叠显示键，模拟树形视图。

2. RedisInsight #

Redis官方推出的可视化工具，支持：

• 自动解析JSON格式的键值，展示完整树形结构。
• 按键名层级自动分组，清晰呈现拆分式的树形存储结构。
• 完美适配Redis 5.x及以上版本与kubuntu 20.04环境。

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