Laravel9配置CACHE_DRIVER=file时RateLimiter及授权报错问题排查

• CACHE_DRIVER=array时限流失效原因：array驱动是请求级内存缓存，数据仅在单次请求生命周期内存储，请求结束后自动清空，无法跨请求累计接口访问计数，RateLimiter依赖跨请求计数逻辑自然无法正常工作。
• CACHE_DRIVER=file时授权报错、刷新后恢复原因：
  1. file、array驱动天生不支持缓存标签（tag）能力，只有redis、memcached、database驱动支持标签操作。
  2. 用户授权完成的首次重定向请求中，若限流规则里提前加载未初始化会话的用户实例，或认证模块写入权限、会话状态时调用了带标签的缓存方法，就会抛出"This cache store does not support tagging."错误。
  3. 首次请求虽然抛错，但核心会话cookie已经写入客户端，后续刷新请求时认证逻辑直接读取已存在的会话信息，不会再触发带标签的缓存写入操作，错误自动消失。

1. 显式指定限流器使用file存储，避免存储解析错乱
   打开app/Providers/RouteServiceProvider.php文件，在boot()方法中配置限流规则前，添加如下绑定：

   use Illuminate\Support\Facades\RateLimiter;
   
   public function boot()
   {
       // 显式指定限流器使用file缓存存储
       RateLimiter::for('cache', fn($app) => $app['cache']->store('file'));
   
       $this->configureRateLimiting();
       // 原有路由加载、其他配置代码保持不变
   }
   

2. 优化限流规则写法，避免提前触发用户实例加载
   不要在限流规则闭包中无判断直接获取用户，调整configureRateLimiting()方法内的API限流规则：

   protected function configureRateLimiting()
   {
       RateLimiter::for('api', function (Request $request) {
           // 会话未初始化时优先用IP作为限流维度，避免提前触发用户加载的标签缓存操作
           $key = $request->ip();
           if ($request->hasSession() && $request->user()) {
               $key = $request->user()->id;
           }
           return Limit::perMinute(60)->by($key);
       });
   }
   

3. （可选，若上述两步后仍有报错）新增支持标签的专用缓存存储
   若项目中存在其他不可修改的标签缓存调用逻辑，可通过database驱动新增专用标签存储，不影响默认file缓存的使用：
   • 执行命令生成缓存表并执行迁移：

     php artisan cache:table
     php artisan migrate
     

   • 打开config/cache.php，在stores数组中新增配置：

     'tag_supported' => [
         'driver' => 'database',
         'table' => 'cache',
         'connection' => null,
     ],
     

   • 打开app/Providers/AppServiceProvider.php，在register()方法中添加绑定，让所有标签缓存操作自动走该专用存储：

     use Illuminate\Support\Facades\Cache;
     
     public function register()
     {
         $this->app->bind('cache.store.tags', fn() => Cache::store('tag_supported'));
     }
     

保持.env中CACHE_DRIVER=file配置，执行php artisan config:clear清空配置缓存：

• 连续调用API超过限流阈值时，接口正常返回429 Too Many Requests状态，限流生效。
• 走完整用户授权登录流程，首次重定向不再抛出缓存标签相关错误，无需手动刷新即可正常进入登录后页面。

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