使用Maatwebsite\Excel在Laravel 9中导出CSV文件遇下载问题

1. 修复导出类的表头格式错误 #

你的DataExport类中headings()方法返回了二维数组，Schema::getColumnListing('data')本身已经是一维数组，外层额外嵌套的数组会导致表头格式异常，干扰下载逻辑。

修改后的headings()方法：

public function headings(): array{
    return Schema::getColumnListing('data');
}

2. 确保控制器正确返回下载响应 #

即使第二次尝试添加了return，仍可简化逻辑（若无需同时保存文件到服务器，可移除store调用）：

public function download_file_csv()
{
    // 不需要在服务器保存文件的话，直接删除下面这行
    Excel::store(new DataExport, 'dataTemplate.csv');
    return Excel::download(new DataExport, 'dataTemplate.csv', \Maatwebsite\Excel\Excel::CSV);
}

3. 前端请求方式问题（核心诱因） #

如果下载请求是通过AJAX/Fetch发起的，浏览器不会自动触发文件下载（AJAX默认无法处理下载响应），需调整请求方式：

• 改用普通a标签跳转：

  <a href="{{ route('download.csv') }}" target="_blank">下载CSV文件</a>
  

• 若必须用AJAX，手动处理响应：

  fetch('/download-csv')
    .then(res => res.blob())
    .then(blob => {
      const url = window.URL.createObjectURL(blob);
      const a = document.createElement('a');
      a.href = url;
      a.download = 'dataTemplate.csv';
      document.body.appendChild(a);
      a.click();
      window.URL.revokeObjectURL(url);
      document.body.removeChild(a);
    });
  

4. 检查响应头是否被篡改 #

确认项目中没有自定义中间件修改响应头，Laravel Excel的download方法会自动添加Content-Disposition等必要头信息，若被覆盖会导致下载失效。

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