使用全键遍历与硬编码键访问Azure Cache for Redis时结果不一致的问题排查

这种情况确实挺让人挠头的，我之前处理Redis相关问题时也遇到过类似的场景，咱们一步步拆解可能的原因和解决办法：

1. 遍历过程中键值对发生了变化 #

KEYS命令是一次性返回当前所有匹配的键，但从你执行keys = db.keys()拿到键列表，到逐个遍历执行db.get(key)这段时间里，有些键对应的value可能被业务代码修改、删除，或者因为过期被Redis自动清理了。而你直接用db.get('my_key')和Redis Insights查询都是实时获取最新值，所以会出现结果不一致的情况。

另外要注意：KEYS命令在Redis实例键数量较多时会阻塞整个服务，生产环境非常不推荐使用。建议换成SCAN命令来迭代获取键，它是分批返回键，能减少遍历的时间窗口，降低数据不一致的概率，同时避免阻塞Redis。Python客户端里可以这么写：

for key in db.scan_iter():
    entry = db.get(key)

2. 键的实际内容和你以为的不一样 #

Redis的键是严格区分大小写的，而且会保留所有特殊字符（比如空格、换行符、不可见字符），有时候你遍历拿到的键和硬编码的'my_key'看起来一样，但实际可能存在差异：

• 比如大小写不同：'My_Key' vs 'my_key'
• 键是bytes类型，而你硬编码的是字符串（Python的Redis客户端默认返回bytes类型的键）
• 键里隐藏了特殊字符，比如末尾多了个空格

排查方法很简单，把遍历到的键用repr()打印出来，查看它的原始内容：

keys = db.keys()
for key in keys:
    print(f"键的原始内容: {repr(key)}")
    # 注意和bytes类型的键比较
    if key == b'my_key':
        entry = db.get(key)
        print(f"对应的值: {entry}")

3. 不小心连接了不同的Redis数据库 #

Azure Cache for Redis默认提供16个独立的数据库（编号0-15），如果你的遍历操作是在数据库0，而硬编码db.get('my_key')时连接的是数据库1，那结果肯定对不上。Redis Insights里会显示你当前查询的数据库编号，可以对比检查代码里的数据库配置：

# 查看当前客户端连接的数据库编号
print(f"当前使用的Redis数据库: {db.connection_pool.connection_kwargs.get('db', 0)}")

4. 键的过期时间导致的差异 #

如果my_key设置了过期时间，可能你执行keys = db.keys()时它还存在，但等到遍历到这个键的时候，它已经过期被Redis删除了，这时候db.get(key)会返回None，而直接查询或者Redis Insights查询时它还没过期，所以能拿到值。

可以用这个命令查看键的剩余过期时间：

ttl = db.ttl('my_key')
if ttl == -2:
    print("键已不存在")
elif ttl == -1:
    print("键永不过期")
else:
    print(f"键剩余过期时间: {ttl}秒")

总结 #

优先排查KEYS命令的时间窗口问题，换成SCAN迭代是最稳妥的方案；然后检查键的真实内容、数据库是否匹配，最后确认键的过期情况，基本就能找到问题所在了。

备注：内容来源于stack exchange，提问作者JoeBloggs