Laravel Excel 导出空白文件问题排查与解决方案

霞舞

发布时间：2025-08-13 18:34:33

|

647人浏览过

|

来源于php中文网

原创

// routes/web.php
Route::post('users/export/', 'App\Http\Controllers\Admin\ReportController@exportvehicles')->name('exportVehiclesToExcel');

    @csrf
    选择员工
    
        ----------------选择-----------------
        @foreach ($staff as $staffMember)
        input('smsstaff_key') === $staffMember->smsstaff_key ? 'selected="selected"' : ''}}>{{$staffMember->name}}
        @endforeach
    
    根据选择的员工筛选

    

注意:

CoCo

智谱AI推出的首个有记忆的企业自主Agent智能体

下载

• 添加了 @csrf 指令，用于防止 CSRF 攻击。
• 使用了 route() 函数生成路由 URL，确保 URL 的正确性。
• 将导出按钮 修改为 。

3. 修改控制器

修改控制器方法，正确接收表单提交的参数，并传递给 Excel 导出类。

public function exportvehicles(Request $request)
{
    $startDate = $request->startDate;
    $endDate = $request->endDate;
    $smsStaffKey = $request->smsstaff_key;

    return Excel::download(new ExportV($startDate, $endDate, $smsStaffKey), 'excelname.xlsx');
}

4. 修改 Excel 导出类

修改 Excel 导出类，使其能够接收控制器传递的参数，并正确地应用到查询条件中。

use Maatwebsite\Excel\Concerns\FromQuery;
use Maatwebsite\Excel\Concerns\Exportable;

class ExportV implements FromQuery
{
    use Exportable;

    public $startDate;
    public $endDate;
    public $smsStaffKey;

    function __construct($startDate, $endDate, $smsStaffKey = null)
    {
        $this->startDate = $startDate;
        $this->endDate = $endDate;
        $this->smsStaffKey = $smsStaffKey;
    }

    public function query()
    {
        $startDate = $this->startDate;
        $endDate = $this->endDate;

        return VehicleLog::join('vehicle', 'vehicleslog.vehicle_id', '=', 'vehicle.id')
            ->join('smsstaff', 'vehicleslog.smsstaff_key', '=', 'smsstaff.smsstaff_key')
            ->when($this->smsStaffKey, function ($query) {
                $query->where('smsstaff.smsstaff_key', $this->smsStaffKey);
            })
            ->whereDate('log_dt', '>=', $startDate)
            ->whereDate('log_dt', '<=', $endDate);
    }
}

注意:

• 构造函数接收 $startDate, $endDate, 和 $smsStaffKey 参数。
• query() 方法中使用 $this->startDate、$this->endDate 和 $this->smsStaffKey 来构建查询条件。
• 使用 when() 方法，只有当 $this->smsStaffKey 存在时，才添加 where 条件。
• 确保返回的是一个查询构建器对象，而不是查询结果集合。

总结

解决 Laravel Excel 导出空白文件的问题，需要从路由配置、表单提交方式、控制器参数接收以及 Excel 导出类的实现等多个方面进行排查和修改。 通过将 GET 请求改为 POST 请求，正确地传递参数，并确保 Excel 导出类能够正确地应用查询条件，可以有效地解决这个问题。

注意事项:

• 确保 maatwebsite/excel 库已正确安装。
• 检查数据库连接是否正常。
• 检查数据表中是否存在符合查询条件的数据。
• 如果导出的数据量很大，可以考虑使用队列来处理导出任务，以避免请求超时。
• 根据实际需求，可以自定义 Excel 导出类的更多功能，例如设置表头、格式化数据等。

通过遵循以上步骤，你应该能够成功解决 Laravel Excel 导出空白文件的问题，并实现数据的正确导出。如果仍然遇到问题，请仔细检查代码和配置，并参考 maatwebsite/excel 官方文档。