Laravel结合事件与Webhooks：缓存清除失效问题求助

问题背景 #

实现「处理」按钮功能时，通过Laravel事件订阅器管理缓存：InitialSyncServerRequested事件触发时设置缓存，SyncServerFinished事件触发时清除缓存。使用Redis同时处理队列与缓存，事件按顺序同步触发，但Cache::forget('syncServer')始终无法清除缓存。

排查步骤与解决方案 #

1. 确认缓存键完全一致 #

检查设置与清除缓存时的键名大小写、前缀是否完全匹配：

• 查看config/cache.php的prefix配置，Laravel默认会给所有缓存键添加前缀，确保清除操作使用的键包含正确前缀
• 通过Redis CLI验证键的实际存储名称：

  redis-cli KEYS "*syncServer*"
  

2. 验证Redis连接实例 #

由于Redis同时处理队列和缓存，可能存在不同数据库/连接的问题：

• 检查config/cache.php中Redis驱动的connection和database配置，确认缓存使用的Redis实例与队列一致
• 手动指定缓存驱动执行清除操作，避免实例混淆：

  public function clearCache(): void
  {
      Cache::store('redis')->forget('syncServer');
  }
  

3. 确认事件订阅器已注册 #

确保SyncCacheSubscriber已添加到EventServiceProvider的订阅列表：

// app/Providers/EventServiceProvider.php
protected $subscribe = [
    \App\Server\Listeners\SyncCacheSubscriber::class,
];

• 在clearCache中添加日志，验证方法是否被执行：

  use Illuminate\Support\Facades\Log;
  
  public function clearCache(): void
  {
      Log::info('Attempting to clear syncServer cache');
      Cache::forget('syncServer');
      Log::info('syncServer cache exists after forget: ' . Cache::has('syncServer'));
  }
  

  查看storage/logs/laravel.log确认日志输出，判断方法是否触发。

4. 排除事务时序问题 #

如果事件触发逻辑包含数据库事务，可能存在事件在事务提交前执行的情况，导致缓存清除后被后续操作覆盖：

• 使用DB::afterCommit延迟执行缓存清除，确保在事务提交后执行：

  public function clearCache(): void
  {
      \Illuminate\Support\Facades\DB::afterCommit(function () {
          Cache::forget('syncServer');
      });
  }
  

5. 基础缓存操作测试 #

先脱离事件系统，在tinker中验证Redis缓存操作是否正常：

php artisan tinker
>>> Cache::put('syncServer', 123);
>>> Cache::has('syncServer'); // 应返回true
>>> Cache::forget('syncServer');
>>> Cache::has('syncServer'); // 应返回false

如果基础操作失效，说明Redis驱动配置有问题，检查config/database.php中的Redis连接配置。

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