Laravel 5.5使用Maatwebsite Excel实现AJAX生成Excel后即时下载

首先得明确：AJAX没法直接处理文件下载的二进制响应，这就是你当前遇到的核心问题——你拿到了服务器上的文件绝对路径，但前端没法直接通过这个路径触发下载。下面给你两种可行的解决方案，按需选择：

方案1：替换AJAX为表单提交（最简单直接） #

文件下载本身属于同步请求场景，用表单提交代替AJAX会更顺畅，不需要额外处理URL或路由。

前端代码修改 #

把原来的AJAX逻辑改成动态创建表单提交，这样能把选中的数据传递给控制器：

// 绑定到导出按钮的点击事件
function triggerExport() {
    // 创建临时表单
    const exportForm = $('<form>', {
        method: 'POST',
        action: '/administrator/adminUser/exportselected/1/'
    });

    // 添加CSRF令牌（Laravel必填）
    exportForm.append($('<input>', {
        name: '_token',
        type: 'hidden',
        value: _token
    }));

    // 循环添加选中的用户ID（假设selected是数组）
    $.each(selected, (index, userId) => {
        exportForm.append($('<input>', {
            name: 'selected[]',
            type: 'hidden',
            value: userId
        }));
    });

    // 循环添加选中的字段（假设selectedField是数组）
    $.each(selectedField, (index, field) => {
        exportForm.append($('<input>', {
            name: 'selectedField[]',
            type: 'hidden',
            value: field
        }));
    });

    // 提交表单并移除临时元素
    exportForm.appendTo('body').submit();
    exportForm.remove();
}

控制器代码修改 #

直接返回Excel的下载响应，同时如果需要保留文件到storage/export，可以先执行store再download：

public function exportSelected()
{
    // 这里保留你获取$adminUserDataExcelSelected的原有逻辑
    $excelName = 'Admin-Users' . date('Y-m-d H:i:s');

    ob_end_clean();
    ob_start();
    
    // 创建Excel实例
    $excel = Excel::create($excelName, function($excel) use($adminUserDataExcelSelected) {
        $excel->sheet('Sheet 1', function($sheet) use($adminUserDataExcelSelected) {
            $sheet->fromArray($adminUserDataExcelSelected);
        });
    });

    // 可选：将文件存储到storage/export目录
    $excel->store('xlsx', storage_path('export'));

    // 直接返回下载响应，浏览器会自动触发下载
    return $excel->download('xlsx');
}

方案2：保留AJAX，通过路由触发下载（适合需前置逻辑的场景） #

如果你一定要用AJAX（比如需要先做前端验证或状态提示），可以让控制器返回一个可访问的下载URL，再由前端触发下载。

步骤1：添加下载路由 #

在routes/web.php中新增专门处理导出文件下载的路由：

Route::get('/download-export/{filename}', 'YourAdminController@downloadExport')->name('download.export');

步骤2：添加下载处理方法 #

在控制器中新增方法，读取存储的Excel文件并返回下载响应：

public function downloadExport($filename)
{
    $filePath = storage_path("export/{$filename}.xlsx");

    // 文件不存在则返回404
    if (!file_exists($filePath)) {
        abort(404, '导出文件不存在');
    }

    // 返回下载响应触发浏览器下载
    return response()->download($filePath);
}

步骤3：修改原导出控制器方法 #

让原方法返回生成的文件对应的下载URL，而非绝对路径：

public function exportSelected()
{
    $excelName = 'Admin-Users' . date('Y-m-d H:i:s');

    ob_end_clean();
    ob_start();
    
    Excel::create($excelName, function($excel) use($adminUserDataExcelSelected) {
        $excel->sheet('Sheet 1', function($sheet) use($adminUserDataExcelSelected) {
            $sheet->fromArray($adminUserDataExcelSelected);
        });
    })->store('xlsx', storage_path('export'));

    ob_flush();

    // 生成可访问的下载URL
    $downloadUrl = route('download.export', ['filename' => $excelName]);

    return response()->json(['url' => $downloadUrl]);
}

步骤4：修改前端AJAX逻辑 #

拿到下载URL后，通过创建a标签触发下载（兼容性更好）：

$.ajax({
    url: "/administrator/adminUser/exportselected/1/",
    type:'POST',
    data: {_token:_token, selected:selected, selectedField:selectedField},
    success: function(data) {
        // 创建临时a标签触发下载
        const downloadLink = document.createElement('a');
        downloadLink.href = data.url;
        downloadLink.download = ''; // 可指定下载文件名，比如从URL中提取
        document.body.appendChild(downloadLink);
        downloadLink.click();
        document.body.removeChild(downloadLink);
    }
});

注意事项 #

• 方案1是文件下载的常规做法，推荐优先使用，避免不必要的复杂度
• 确保storage/export目录有正确的写入权限（通常设置为755或775）
• 你使用的是Maatwebsite Excel 2.x版本（对应Laravel 5.5），Excel::create的API是正确的，新版本API会有差异

内容的提问来源于stack exchange，提问作者Niladri Banerjee - Uttarpara