最直接方式是用@patch('redis.redis')装饰测试方法,使每次redis()调用返回统一mock实例,并设get/set等方法的return_value或side_effect以控制返回值,注意返回bytes类型且需匹配真实客户端行为。

用 unittest.mock.patch 替换 redis.Redis 实例最直接
测试中不需要真实连 Redis,关键是让被测代码调用的 redis.Redis 方法返回可控结果。最常用方式是 patch 类本身,而不是 patch 已创建的实例(后者容易漏掉初始化路径)。
常见错误:在测试里手动传入一个 mock 对象进业务函数——这会污染函数签名,且绕过实际初始化逻辑,导致漏测连接参数、重试配置等。
- 在测试方法上加
@patch('redis.Redis'),或在setUp里用patcher = patch('redis.Redis')启动 - 被 patch 的
redis.Redis类,每次被调用都会返回同一个 mock 实例,可统一设return_value - 若业务代码用了连接池(
redis.ConnectionPool),要 patch 的是redis.Redis,不是ConnectionPool—— 因为最终调用的是Redis(...)构造器
模拟 get/set 等具体方法行为要设 side_effect 或 return_value
只 mock 类还不够,得控制具体方法的返回值。比如 cache.get('user:123') 应该返回 b'{"id":123}',而第二次调用可能想让它返回 None 模拟缓存穿透。
注意:Redis 客户端返回的是 bytes,不是字符串,mock 返回字符串(如 '{"id":123}')会导致 json.loads 报错:TypeError: the JSON object must be str, bytes or bytearray。
- 用
mock_redis.get.return_value = b'{"id":123}'模拟单次命中 - 用
mock_redis.get.side_effect = [b'{"id":123}', None, b'{"id":456}']模拟多次调用不同结果 -
set方法默认返回True,但如果你验证了返回值(比如if cache.set(...) == True),就得显式设mock_redis.set.return_value = True
用 fakeredis 替代 mock 更接近真实行为
当测试逻辑依赖 Redis 命令间的交互(比如先 setex 再 ttl,或用 pipeline 批量操作),纯 mock 很难覆盖状态流转,这时 fakeredis 是更省心的选择——它实现了 Redis 协议子集,在内存里跑,不发网络请求,API 兼容官方客户端。
容易踩的坑:fakeredis 默认不支持 Lua 脚本(eval)、不支持集群模式、某些边缘命令(如 georadius)可能未实现。上线前高频使用的命令务必确认已支持。
- 安装:
pip install fakeredis - 替换初始化:
redis.Redis = fakeredis.FakeRedis(全局替换)或直接构造fakeredis.FakeRedis() - 它自动处理类型转换(比如
set('k', 123)存的是b'123'),和真实 Redis 行为一致
测试缓存失效逻辑时别忘了清空 fakeredis 实例
多个测试方法共用同一个 fakeredis.FakeRedis() 实例会导致状态残留,比如前一个测试 set('flag', 'on'),后一个测试没清理就去读,结果不符合预期。
这不是 bug,是设计如此——fakeredis 默认用共享内存存储,类似真实 Redis 实例。不清理就相当于测试间有隐式依赖。
- 每个测试方法开头调用
fake_redis.flushdb()(清空当前 DB) - 或者在
setUp里重新构造新实例:self.redis = fakeredis.FakeRedis() - 如果用了
@patch('redis.Redis')+fakeredis,记得 patch 的是类,所以每次Redis()调用都会新建一个干净实例,反而不用手动 flush
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











