Laravel项目报错：Spatie\Permission\Middlewares\PermissionMiddleware不存在求助

排查与解决方案 #

• 检查中间件类路径
  Spatie Laravel Permission 6.0的权限中间件类路径为Spatie\Permission\Middleware\PermissionMiddleware（注意是单数Middleware，而非报错中的复数Middlewares）。请确认app/Http/Kernel.php里注册的中间件是否写错了复数形式。

• 重新发布包配置文件
  执行命令更新配置文件，确保引用路径为最新版本：

  php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="permission-config"
  

• 清除项目缓存
  依次执行以下命令清除各类缓存，避免旧路径缓存导致的问题：

  php artisan cache:clear
  php artisan config:clear
  php artisan route:clear
  composer dump-autoload
  

• 确认包安装完整性
  执行composer show spatie/laravel-permission查看包的安装状态，若存在异常，执行强制重新安装命令：

  composer require spatie/laravel-permission:6.0 --force
  

• 检查Jetstream/Livewire中的中间件引用
  若在Jetstream的路由或Livewire组件中使用了该中间件，确认引用的类路径为正确的单数形式Middleware，避免因复制旧文档或代码导致的路径错误。

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