PHP文生图缓存失效？Redis配置法-php教程-PHP中文网

文生图缓存总失效的最常见原因是未用setex设置ttl，而用set导致键永不过期、内存满后被lru随机淘汰；必须用setex明确过期时间、压缩base64、精准构造键名、做好异常兜底。

php文生图缓存失效？redis配置法

setex 和 set 没设过期时间，是 PHP 文生图缓存总失效的最常见原因 —— 不是 Redis 本身出问题，而是你没告诉它“这张图该活多久”。

为什么文生图缓存一查就空？

文生图（比如用 Stable Diffusion API 返回 base64 图片）结果通常体积大、生成耗时，本该缓存 24 小时，但实际不到 5 分钟就取不到了。根本原因是：set 默认永不过期，而 Redis 内存满后会按 maxmemory-policy 清理；setex 才真正绑定 TTL。

set('img:hash123', $base64) → 没过期时间，靠 LRU 被踢，不可控
setex('img:hash123', 86400, $base64) → 明确存活 24 小时，可预测
若用 set + 后续 expire('img:hash123', 86400)，中间有竞态窗口：写入后、设过期前崩了，键就变永驻

大图缓存必须压缩再存？

Redis 是内存数据库，$base64 图片字符串可能达 2–5MB，直接 setex 会导致单 key 占用过高、阻塞其他请求，甚至触发 maxmemory 淘汰。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

用 gzdeflate() 压缩后再存：$redis->setex('img:hash123', 86400, gzdeflate($base64))
读取时解压：gzinflate($redis->get('img:hash123'))
实测 JPEG base64 压缩率常达 60%–75%，内存压力大幅下降
别用 serialize() 包裹 base64 —— 它反而增大体积，且无压缩效果

键名设计影响缓存命中率

文生图参数稍有不同（如 seed=42 vs seed=43），就该是不同缓存项。但若键名只哈希 prompt，忽略分辨率、模型版本等关键维度，就会「伪命中」—— 取到一张尺寸错乱或风格不符的图。

推荐构造方式：md5("sdxl_v1.0_1024x1024_" . $prompt . "_" . $seed)
避免只用 md5($prompt) —— 缺少上下文，冲突风险高
不要把整个参数数组 json_encode() 后哈希 —— 多余字段（如 timestamp）导致相同语义生成不同 key
加前缀如 img: 方便 keys img:* 调试，但生产禁用 keys，改用 scan

连接异常时缓存逻辑不能崩

Redis 服务短暂不可用（如网络抖动、OOM 重启），如果代码里没兜底，$redis->get() 抛出异常或返回 false，而你又没判空就直接 json_decode 或输出 base64，页面就白屏或报错。

始终检查返回值：$cached = $redis->get($key); if ($cached !== false) { /* 解压/解码 */ }
连接阶段加超时与重试：$redis->connect('127.0.0.1', 6379, 2.5)（单位秒）
密码验证失败会静默失败，务必加 auth() 后调用 ping() 确认：if ($redis->ping() !== '+PONG') { /* 切数据库或降级 */ }
缓存未命中时，记得把新生成的图也走一遍压缩 + setex 流程，否则下次还是查不到

缓存失效往往不是 Redis 的锅，而是 TTL 没写死、键名太粗糙、大图没压缩、异常没兜底 —— 这四点漏掉任意一个，文生图缓存就形同虚设。