Laravel 5.4中Redis自动生成空键的原因排查与解决

一、空键生成的可能成因 #

1. Laravel缓存操作边界问题
   Laravel 5.4的Redis缓存驱动在执行Cache::put()/Cache::add()时，若存入null值会创建空键；使用Cache::remember()时，回调函数返回null也会生成空键。
2. 依赖包隐性操作
   • zizaco/entrust 5.2.x-dev（开发版）：缓存角色、权限关联关系时，若对应关联数据不存在，可能写入空缓存键。
   • tymon/jwt-auth 0.5.*：旧版本处理无效token或缓存token黑名单时，存在生成空键的潜在问题。
3. Redis客户端异常
   Predis 1.1版本在网络波动场景下，可能出现命令执行不完整，只创建键但未写入值的情况。
4. 业务代码疏漏
   业务逻辑中若先创建键再赋值，中间因异常中断会留下空键；或误执行Redis::set('key', '')这类写入空字符串的操作。

二、空键的生成时机 #

• 缓存预加载阶段：系统启动或首次访问时，依赖包预缓存权限、配置等数据，对应数据为空则生成空键。
• 业务请求处理中：执行缓存查询/写入操作时，数据源返回null/空值，未做判断直接存入缓存。
• 异常场景下：网络中断、代码抛出异常导致缓存写入流程不完整，仅完成键的创建。

三、解决办法 #

1. 代码层面优化 #

• 缓存写入前校验值有效性：所有缓存写入操作前，判断值是否为null或空字符串，避免写入空值：

// 错误写法
Cache::put('user:'.$id, $user, 60);
// 正确写法
if (!is_null($user) && !empty($user)) {
    Cache::put('user:'.$id, $user, 60);
}

• 修复依赖包问题：
  • 升级zizaco/entrust到稳定版本（开发版存在不确定性），或手动修改包内缓存逻辑，跳过空值缓存。
  • 升级tymon/jwt-auth到0.5.x最新稳定版，检查黑名单缓存逻辑，避免写入空值。
• 优化Cache::remember用法：确保回调函数不返回null，或用空值替代方案：

$role = Cache::remember('role:'.$id, 60, function () use ($id) {
    $role = Role::find($id);
    return $role ?: []; // 用空数组替代null
});

2. Redis层面清理与预防 #

• 批量清理现有空键：执行Redis命令删除空键（生产环境建议先测试）：

EVAL "local keys = redis.call('KEYS', '*') for i,k in ipairs(keys) do local v = redis.call('GET', k) if v == nil or v == '' then redis.call('DEL', k) end end" 0

• 强制设置键的过期时间：所有缓存键都配置合理TTL，空键会自动清理，避免长期占用内存。
• 监控键状态：用redis-cli info keyspace或RedisInsight定期检查空键数量，及时发现问题。

3. 排查工具辅助 #

• 开启Laravel缓存日志：在.env中配置日志记录缓存操作，追踪空键来源：

LOG_CHANNEL=stack
LOG_LEVEL=debug

• 开启Redis慢查询日志：记录异常命令，排查空键生成操作：

config set slowlog-log-slower-than 1000
config set slowlog-max-len 1000

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