Laravel Redis缓存需显式设CACHE_DRIVER=redis，标签通过前缀模拟存在竞态风险，原子锁必须用Cache::lock()而非手动SETNX，混合使用时应加锁前缀防键冲突。

Redis 缓存驱动配置必须显式启用

Laravel 默认不强制使用 Redis 作为缓存后端，即使 redis 扩展已安装、REDIS_HOST 已配置，CACHE_DRIVER 仍默认为 file 或 array。不改这个，所有 Cache::get() 都不会走 Redis。

实操建议：

• 确认 .env 中设置 CACHE_DRIVER=redis（不是 redis_cache 或其他别名）
• 确保 config/cache.php 的 'stores.redis.connection' 指向 config/database.php 中已定义的 Redis 连接名（如 default）
• 运行 php artisan config:clear，避免配置缓存干扰

标签（Tag）在 Redis 中实际是前缀模拟，非原生支持

Laravel 的 Cache::tags() 在 Redis 驱动下并不依赖 Redis 的原生集合或键空间通知，而是通过字符串前缀 + 单独维护的“标签索引键”来实现。这意味着：标签删除（flushTags）本质是查索引键 → 批量删匹配前缀的键 → 清空索引键，存在竞态风险和延迟。

常见错误现象：

• 调用 Cache::tags(['user'])->flush() 后，部分键未被清除 —— 因为索引键读取与批量删除之间有其他进程写入新键
• 高并发下 Cache::tags(['report'])->put('2025-06', $data, 3600) 可能导致索引键重复写入或丢失

性能影响：每次打标写入会额外执行 2 次 Redis 命令（LPUSH 索引 + EXPIRE），读取带标签数据不额外开销，但删标签代价显著高于直删

原子锁必须用 Cache::lock() 而非手写 SETNX

直接用 Redis::setnx('lock:order:123', 1) + expire 组合无法保证原子性，Redis 5.0+ 虽支持 SET key value EX seconds NX，但 Laravel 的 Cache::lock() 封装了自动续期（ttl 刷新）、释放校验（防止误删他人锁）、超时兜底等关键逻辑。

使用场景示例（防重复下单）：

use Illuminate\Support\Facades\Cache;

$lock = Cache::lock('order:'. $order->id, 30); // 30秒过期

if ($lock->get()) {
    try {
        // 执行扣库存、生成支付单等敏感操作
        processOrder($order);
    } finally {
        $lock->release(); // 必须显式释放，否则锁残留
    }
} else {
    throw new Exception('Order is being processed');
}

容易踩的坑：

• 忘记 finally 中调用 $lock->release()，导致锁永久占用
• 传入的过期时间（第二参数）单位是秒，不是毫秒；且该值应大于业务逻辑最大耗时，否则锁自动释放后可能被其他请求抢占
• 在队列任务中使用锁时，需确保锁驱动与队列驱动共享同一 Redis 连接（检查 config/queue.php 和 config/cache.php 的 connection 配置是否一致）

混合使用标签与原子锁时注意键名冲突

当同时使用 Cache::tags(['payment'])->put('txn_abc', $data) 和 Cache::lock('txn_abc')，Laravel 会分别生成类似 payment:txn_abc 和 txn_abc 的键。看似隔离，但若业务中手动拼接键名（如 cache_key('payment', $id)），极易与锁名重叠，造成 lock()->get() 失败或缓存误删。

建议做法：

• 为锁名加固定前缀，例如统一用 lock: 开头：Cache::lock('lock:txn_abc')
• 标签名避免使用可能作为锁名的短标识（如不用 ['order'] 标签，而用 ['cache:order']）
• 用 redis-cli --scan --pattern '*txn_abc*' 定期验证键命名空间是否干净

Redis 键空间没有命名空间隔离机制，靠约定和前缀管理，这点比数据库 schema 更易出错。