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('2024-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 更易出错。
