Python脚本解码Redisson FST编码Redis键的实现方法

当前问题的核心成因 #

Redisson默认使用的FSTCodec，会对所有存入Redis的键、哈希字段添加FST序列化的前缀元数据，这类元数据包含非法UTF-8字节，开启decode_responses=True时会直接抛出解码错误；同时这类前缀的结构会随FST版本变化，不需要硬编码偏移量做强制剥离。

不修改Java侧Redisson配置的可落地方案 #

完全可以在不更换Redisson编码的前提下完成字段定位与删除，核心逻辑是利用FST编码的字符串字段会完整保留原始字符串字节在编码结果末尾的特性，避免依赖不稳定的前缀结构做计算：

• 保持redis-py的默认配置，即不开启decode_responses，所有操作的入参、返回值都使用bytes类型，从根源避免解码报错
• 先筛选匹配的顶层Redis键，校验键的类型为hash，避免扫到其他同名字段导致操作错误
• 读取哈希的所有字段字节列表，直接通过后缀匹配的方式，筛选出末尾等于目标原始字段名（比如b'key1'）的条目
• 将匹配到的字段字节原样传给hdel方法执行删除，不需要做任何前缀转换或字符串解码

可直接运行的测试脚本：

import redis

# 保持默认配置，返回所有值为bytes类型，不做自动解码
r = redis.StrictRedis()

# 1. 扫描目标哈希键（生产环境建议替换为scan_iter避免阻塞）
all_matched_keys = r.keys(pattern='*key*')
target_hash_key = None
for key in all_matched_keys:
    # 仅选择类型为hash的键，排除其他数据类型
    if r.type(key) == b'hash':
        target_hash_key = key
        break

if not target_hash_key:
    print("未找到匹配的哈希键")
    exit()

# 2. 匹配目标哈希字段
target_field_list = []
for field in r.hkeys(target_hash_key):
    # 检查字段末尾是否为原始的"key1"字节
    if field.endswith(b'key1'):
        target_field_list.append(field)

# 3. 执行删除
if target_field_list:
    del_count = r.hdel(target_hash_key, *target_field_list)
    print(f"成功删除 {del_count} 个匹配字段")

之前取值返回None的常见原因 #

• 手动开启了decode_responses=True，拿到的字段bytes被错误解码，传给hget的字节序列和Redis中实际存储的内容不一致
• 对拿到的字段bytes手动做字符串解码时，非法的FST前缀字节被替换、截断，传给hget的参数和Redis实际存储的字段字节不一致
• 通过keys扫描到的目标键不是实际存储哈希的键，存在同名字符串键、其他前缀带key的无关键

关于是否需要更换Redisson编码 #

• 如果仅需要临时做几次字段清理，完全不需要调整Java侧的配置，上述脚本即可满足需求
• 如果后续需要长期让Python脚本高频操作这批Redis数据，可以单独给目标RHash设置StringCodec，仅将哈希的键、字段编解码调整为纯字符串存储，值依然保留原有的FST序列化逻辑，不需要全局换成JsonJacksonCodec，对原有业务零侵入

注意：不要尝试硬计算FST编码的前缀长度做剥离，不同版本的FST短字符串前缀偏移规则会有差异，硬编码的逻辑很容易在版本升级后失效，后缀匹配的方式兼容性最强。

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