Laravel生产环境Redis缓存不支持标签问题求助

这种突发的“cache store does not support tagging”错误确实让人头疼，尤其是之前Redis缓存一直正常运行的情况下。结合你用Forge部署的场景，我整理了几个最可能的排查方向：

1. 确认生产环境的缓存驱动配置真的生效了 #

Laravel会缓存配置文件来提升性能，这经常是部署后配置不生效的元凶。即使你修改了.env里的CACHE_DRIVER=redis，如果之前的配置缓存没清除，应用还是会用旧的配置。

• 先在生产环境SSH终端运行：

  php artisan config:clear
  

• 然后用tinker验证当前驱动：

  php artisan tinker
  # 输入以下命令并回车
  Cache::getDefaultDriver()
  

  如果返回的不是redis，说明配置还是没加载正确，你需要检查.env文件是否被正确上传到生产环境，或者有没有被Forge的部署脚本覆盖。

2. 检查config/cache.php中的Redis存储配置 #

确保你的Redis缓存存储配置是支持标签的。打开config/cache.php，找到stores数组里的redis项：

'redis' => [
    'driver' => 'redis',
    'connection' => 'cache', // 这里要对应config/database.php里的Redis连接
    'lock_connection' => 'default',
],

• 确认driver是redis，而不是其他不支持标签的驱动；
• 检查connection对应的Redis连接在config/database.php里是正常配置的，并且该Redis实例是可用的；
• 另外，不要在代码里手动指定不支持标签的缓存存储（比如Cache::store('file')->tags(...)），这种硬编码会直接导致错误。

3. 检查Forge部署脚本的配置缓存步骤 #

Forge默认的部署脚本会包含php artisan config:cache，如果你的.env修改是在部署脚本执行之后才生效的，那缓存的配置还是旧的。

• 打开Forge的站点部署设置，确保部署脚本的顺序是：
  1. 拉取代码
  2. 安装依赖（如果需要）
  3. 清除旧配置缓存
  4. 生成新的配置缓存
     比如脚本可以调整为：

  cd /home/forge/your-site.com
  git pull origin main
  composer install --no-interaction --prefer-dist --optimize-autoloader
  php artisan config:clear
  php artisan config:cache
  php artisan route:cache
  php artisan view:cache
  php artisan migrate --force
  

  这样能保证新的.env配置被正确加载并缓存。

4. 排查是否有代码层面的临时切换 #

有时候开发者会在代码里临时切换缓存存储（比如调试时），然后忘记改回来。全局搜索你的代码库，看看有没有类似：

Cache::store('file')->tags(['your-tag'])->put(...);

或者在某个服务提供者里修改了默认缓存驱动，这种情况会导致标签调用使用了不支持的存储。

5. 验证Redis扩展/客户端的兼容性 #

虽然之前正常运行，但如果最近执行了composer update更新了依赖，可能出现Redis客户端（比如Predis或phpredis扩展）的兼容性问题。

• 检查composer.json里的依赖，确保laravel/framework版本和predis/predis（如果用的是Predis）或者phpredis扩展版本兼容；
• 可以尝试重新安装依赖：

  composer install --no-dev --optimize-autoloader
  

如果以上步骤都试过还是没解决，你可以在生产环境运行redis-cli连接到Redis实例，执行KEYS *看看有没有缓存标签相关的键（通常前缀是laravel_cache:），确认Redis本身是正常接收缓存请求的。

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