Laravel 10.48.4安装maatwebsite/excel异常：默认安装废弃1.1版本而非3.3

问题原因 #

Laravel 10 + PHP8.2环境下，直接执行composer require maatwebsite/excel会默认拉取已停止维护的1.1版本——这是因为旧版本包在Packagist上的版本约束未适配高版本Laravel，导致Composer自动选择了兼容的旧版本。

解决步骤 #

1. 卸载已安装的旧版本
   先移除已安装的1.1版本，避免后续依赖冲突：

   composer remove maatwebsite/excel
   

2. 明确指定3.3版本安装
   直接指定目标版本执行安装，3.3版本完全兼容Laravel 10和PHP8.2：

   composer require maatwebsite/excel:3.3
   

3. 处理依赖冲突（若安装时报错）
   如果执行上述命令仍报错，大概率是现有项目依赖与3.3版本的核心依赖存在冲突，可尝试以下操作：

   • 清除Composer缓存，避免旧依赖缓存干扰：

     composer clear-cache
     

   • 强制更新相关依赖，自动适配兼容版本：

     composer require maatwebsite/excel:3.3 --with-all-dependencies
     

   • 检查composer.json中是否存在与phpoffice/phpspreadsheet（maatwebsite/excel的核心依赖）冲突的版本约束，3.3版本要求phpoffice/phpspreadsheet:^1.18|^2.0，可手动调整该依赖版本后重新执行安装。

4. 安装后配置（可选）
   如需自定义Excel组件的配置规则，可发布组件的配置文件：

   php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider"
   

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