Laravel中已安装GuzzleHttp\Client仍提示类未找到问题求助

从你提供的日志来看：

[2018-03-23 11:43:06] production.ERROR: Class 'GuzzleHttp\Client' not found {"exception":"[object] (Symfony\Component\Debug\Exception\FatalThrowableError(code: 0): Class 'GuzzleHttp\Client' not found at /home/polymath/saio/public_html/vendor/laravel/framework/src/Illuminate/Mail/TransportManager.php:181)"}

核心问题是Laravel的邮件管理组件找不到Guzzle客户端，虽然你已经通过composer require guzzlehttp/guzzle安装了依赖，但大概率是依赖加载异常或者队列Worker的运行环境和当前操作环境不一致导致的，下面是一步步的排查和解决方法：

• 确认Guzzle依赖是否真的安装到位
  先别急着清缓存，先验证依赖状态：

  1. 打开项目根目录的composer.lock文件，搜索guzzlehttp/guzzle，查看是否存在对应的版本条目；
  2. 检查vendor/guzzlehttp目录是否存在，里面是否有完整的guzzle子目录；
  3. 执行命令 composer show guzzlehttp/guzzle，如果能正常显示Guzzle的版本、描述等信息，说明依赖确实安装成功，否则重新执行composer install（优先用install而非require，避免版本冲突）。

• 重启队列Worker，同步依赖环境
  队列Worker是常驻内存的进程，如果你是启动Worker之后才安装的Guzzle，Worker的内存里不会自动加载新依赖。必须重启Worker才能让它读取新安装的包：

  1. 执行 php artisan queue:restart 发送重启信号；
  2. 重新启动Worker，开发环境用 php artisan queue:work，生产环境建议用守护进程模式，比如php artisan queue:work --daemon（Laravel 5.7+版本可直接用php artisan queue:work搭配守护参数）。

• 彻底清除配置缓存，避免固化错误信息
  你之前执行过php artisan config:cache，这个命令会把所有配置编译成单个缓存文件，如果当时Guzzle还没安装，缓存文件里就会缺少相关依赖的路径映射。正确操作是：

  1. 执行 php artisan config:clear 清除配置缓存；
  2. 暂时不要重新执行config:cache，先测试队列任务是否正常，等问题解决后再按需缓存配置。

• 重新生成Composer自动加载文件
  有时候自动加载文件会出现异常，导致无法找到Guzzle的类：
  执行 composer dump-autoload -o（-o参数是优化自动加载，适合生产环境），这个命令会重新生成vendor/autoload.php和类映射文件，确保Guzzle的类能被正确识别。

• 检查文件权限，确保Worker能读取依赖
  如果队列Worker是用服务器的www-data（或其他非当前用户）运行的，而你用root用户安装了Composer依赖，就会出现权限问题，导致Worker无法读取vendor目录下的文件：
  执行 chown -R www-data:www-data /home/polymath/saio/public_html/vendor/（根据你的项目路径和服务器运行用户调整），把vendor目录的权限设置为Worker进程可读取的用户。

• 排查clear-compiled导致的崩溃问题
  你提到执行php artisan clear-compiled导致应用崩溃，这个命令会清除Laravel编译后的类文件，若自动加载本身有问题，就会导致应用无法启动。解决办法是：

  1. 先执行composer dump-autoload重新生成自动加载；
  2. 除非确定编译文件有问题，否则不要轻易使用clear-compiled，Laravel新版本已经弱化了这个命令的作用。

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