Laravel 8 Redis 缓存标签生效需三步：启用 phpredis 客户端、配置独立 cache 连接并设 'taggable' => true、所有标签操作必须统一使用同一 store 实例。

要让 Laravel 8 的缓存标签（Cache Tags）在 Redis 上真正生效，不是简单调用 Cache::tags() 就行——它默认是关闭的，且依赖特定配置组合。核心就三点：用对 Redis 客户端、配好专用连接、显式启用标签支持。

必须启用 phpredis 并强制 Laravel 使用它

Laravel 8 默认用 predis，但 predis 对标签的支持不稳定，高并发下容易静默失败。phpredis 才是生产环境推荐选择。

• 运行 php -m | grep redis 确认已加载 redis 扩展（不是 phpredis 模块名，输出就是 redis）
• 修改 config/database.php 中的 redis.client 值：
  'client' => 'phpredis'（不能写成 predis）
• 检查 .env 中没有 REDIS_CLIENT=predis 这类覆盖项

配置独立的 cache 连接并绑定到 store

标签功能需要元数据存储空间，不能和 session、queue 共用 database=0，否则会冲突或失效。

Redis Skill - 高性能缓存管理

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

下载

• 在 config/database.php 的 redis.connections 下新增一个连接，比如叫 cache：
  'cache' => [ 'host' => env('REDIS_HOST', '127.0.0.1'), 'password' => env('REDIS_PASSWORD'), 'port' => env('REDIS_PORT', 6379), 'database' => env('REDIS_CACHE_DB', 1) ]
• 在 config/cache.php 的 stores.redis 中指定：
  'connection' => 'cache', 'taggable' => true（这个 taggable => true 是关键，Laravel 8 默认是 false）
• .env 中补上：REDIS_CACHE_DB=1

使用时必须统一 store 实例，不能混用

一旦启用了 taggable，所有带标签的操作都必须走同一个 store，否则元数据 key（如 tags:users:ids）可能写入不同 DB 或被忽略。

• ✅ 正确写法（全部走默认 redis store）：
  Cache::tags(['users'])->put('profile_123', $data, 3600);
Cache::tags(['users'])->flush();
• ❌ 错误写法（混用 store）：
  Cache::tags(['users'])->put(...); // 走 default store
Cache::store('redis')->tags(['users'])->flush(); // 走显式 store —— 不一致，会失效

验证是否真的跑通了

别只看代码有没有报错，要进 Redis 查数据。

• 执行 Cache::tags(['test'])->put('key_a', 'value_a', 60)
• 用 redis-cli -n 1 keys "*"（注意是 DB 1）查看是否生成类似 laravel8:tags:test:ids 和 laravel8:key_a 的 key
• 再执行 Cache::tags(['test'])->flush()，确认那两个 key 都消失了