Laravel9使用maatwebsite3.1导出Excel报未检测到读写类型错误

报错核心触发逻辑是扩展包底层依赖的PhpSpreadsheet无法通过传入的文件名判断要使用的写入驱动，按以下优先级排查即可：

• 检查导出文件名是否带合法扩展名
  maatwebsite/excel 3.1 仅能识别带官方支持后缀的文件名，支持后缀包括xlsx、xls、csv、ods、html，导出为pdf需额外安装对应渲染依赖。禁止传入无后缀、后缀拼写错误的文件名：

  // 错误示例
  Excel::download(new OrderExport(), '订单统计'); // 无文件后缀
  Excel::download(new OrderExport(), '订单统计.xlxs'); // xlsx后缀拼写错误
  
  // 正确示例
  Excel::download(new OrderExport(), '订单统计.xlsx');
  

• 检查动态生成文件名时的后缀丢失问题
  如果文件名通过变量拼接、前端传参、模型字段取值生成，先打印传入导出方法的最终文件名字符串，排查是否存在变量为空、特殊字符过滤截断后缀、拼接时多写非法字符导致后缀失效的问题。如果是在导出类中通过filename()方法定义文件名，同样要保证返回值带合法后缀：

  // 导出类内错误写法
  public function filename(): string
  {
      return '订单统计_' . date('Y-m-d'); // 拼接后无后缀
  }
  
  // 导出类内正确写法
  public function filename(): string
  {
      return '订单统计_' . date('Y-m-d') . '.xlsx';
  }
  

• 显式指定写入类型绕过自动检测
  特殊场景下不需要文件名带后缀时，可以在调用导出方法时传入第三个参数，显式声明写入类型，跳过自动检测逻辑：

  use Maatwebsite\Excel\Excel;
  
  // 显式指定为XLSX格式，文件名无后缀也可正常导出
  Excel::download(new OrderExport(), '订单统计', Excel::XLSX);
  

  常用类型常量对应关系：

  • Excel::XLSX：xlsx格式
  • Excel::XLS：xls格式
  • Excel::CSV：csv格式
  • Excel::DOMPDF：pdf格式（需提前安装dompdf/dompdf依赖）

• 修复依赖安装异常
  以上配置均正常仍报错时，大概率是依赖安装不完整导致类型驱动缺失，执行以下命令重装扩展包并清除缓存即可：

  composer remove maatwebsite/excel
  composer require maatwebsite/excel:^3.1
  php artisan config:clear
  php artisan cache:clear
  

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