Laravel5.5部署服务器报错：Maatwebsite\Excel类找不到及依赖冲突

这个问题的根源其实很明确：你在composer.json里指定的maatwebsite/excel:^3.0版本要求Laravel 5.6及以上，但你的项目是Laravel 5.5，版本完全不兼容，所以服务器端执行composer安装时要么直接报错终止，要么没能正确安装这个依赖，自然就会出现类找不到的错误。

而本地能正常运行，大概率是你本地之前已经安装了兼容Laravel 5.5的旧版本（比如2.1.x系列），后来修改composer.json时误写成了3.0，但没执行composer update，本地依然用的是旧版本，所以没出问题。

给你一套完整的解决步骤：

• 首先修正composer.json里的依赖版本：把maatwebsite/excel:^3.0改成maatwebsite/excel:^2.1，这个版本是专门适配Laravel 5.5的。
• 在本地项目根目录执行composer update maatwebsite/excel，确保本地依赖和配置文件一致，同时生成正确的composer.lock文件，一定要把这个lock文件也同步到服务器——这样服务器执行composer install时会直接按照lock里的版本安装，避免依赖冲突。
• 如果服务器已经尝试过安装，先清理一下缓存：
  • 执行composer dump-autoload，让composer重新生成自动加载映射文件；
  • 再运行php artisan cache:clear和php artisan config:clear，清除Laravel的配置和缓存。

这样操作后，服务器上就能正确安装兼容的Excel扩展，类找不到的问题就解决了。

内容的提问来源于stack exchange，提问作者S.M_Emamian