服务器部署arcanedev/log-viewer报错：找不到指定Filesystem类

针对你遇到的本地正常、服务器部署后出现Class 'Arcanedev\LogViewer\Contracts\Utilities\Filesystem' not found的错误，结合你已做的排查，下面是几个针对性的解决方案：

• 刷新Composer自动加载缓存
  服务器环境下，Composer的自动加载缓存可能没有同步更新，导致新安装的包类无法被识别。执行以下命令：

  # 清除Laravel编译缓存
  php artisan clear-compiled
  # 刷新Composer自动加载映射
  composer dump-autoload
  

  如果是Laravel 5.4+，也可以用php artisan optimize:clear一次性清除所有缓存（包括自动加载缓存）。

• 检查文件/目录大小写一致性
  本地Windows系统不区分文件大小写，但服务器通常是Linux系统，严格区分大小写。确认vendor/arcanedev/log-viewer/src/Contracts/Utilities/Filesystem.php的路径和文件名大小写完全匹配类名的命名空间：Arcanedev\LogViewer\Contracts\Utilities\Filesystem，比如Contracts、Utilities目录和Filesystem.php文件的首字母必须大写。

• 禁用Composer自动加载优化选项
  如果部署时执行composer install用了--optimize-autoloader或--classmap-authoritative参数，可能会导致类映射不完整。尝试重新安装依赖并禁用优化：

  composer install --no-optimize-autoloader
  

  安装完成后再执行composer dump-autoload确保自动加载映射正确生成。

• 验证服务提供者注册与加载顺序
  虽然你已经注册了Arcanedev\LogViewer\LogViewerServiceProvider::class，但如果它在依赖它的服务提供者之后加载，可能会引发类找不到的问题。尝试将LogViewerServiceProvider移到config/app.php的providers数组靠前的位置，确保它在其他需要调用LogViewer类的服务提供者之前被加载。

• 检查Vendor目录权限
  确认服务器的Web进程（比如www-data、nginx用户）对vendor/arcanedev/log-viewer目录及文件有读取权限。可以执行以下命令修复权限：

  chmod -R 755 vendor/arcanedev/log-viewer
  # 或者设置正确的所有者
  chown -R www-data:www-data vendor
  

这些步骤应该能解决你遇到的类找不到问题，建议按顺序尝试，通常刷新自动加载缓存就能解决大部分类似问题。

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