Laravel-Excel导出时返回空白页问题求助

我按照Laravel-Excel 3.1官方快速入门指南实现导出功能，但点击导出链接只返回空白页，无法下载预期的Excel文件。代码与官方示例几乎一致，当前运行环境为PHP 8.2、Laravel 11.5、Laravel-Excel 3.1。

EntriesExport类 #

<?php

namespace App\Exports;

use App\Models\Entry;
use Maatwebsite\Excel\Concerns\FromCollection;

class EntriesExport implements FromCollection
{
    /**
     * @return \Illuminate\Support\Collection
     */
    public function collection()
    {
        return Entry::all();
    }
}

控制器代码 #

public function export()
{
    return Excel::download(new EntriesExport, 'entries.xlsx');
}

路由代码 #

Route::get('/entries/export/', [EntriesController::class, 'export'])->name('excel');

排查与解决方法 #

• 确认Excel门面已导入：检查控制器顶部是否添加了use Maatwebsite\Excel\Facades\Excel;，未导入会导致Excel::download()无法执行，返回空白响应。
• 验证模型数据有效性：在collection()方法中临时添加dd(Entry::all())，确认模型是否有数据。无数据时部分场景会返回空白而非空Excel文件。
• 排查提前输出干扰：确保导出方法执行前没有任何输出（如dd()、echo、var_dump或模板文件中的多余空格），提前输出会破坏Excel响应头，导致浏览器无法识别文件类型。
• 检查依赖兼容性：运行composer update maatwebsite/excel确保依赖正确安装，虽然Laravel 11.5与PHP 8.2理论兼容Laravel-Excel 3.1，但版本冲突可能导致异常。
• 调试响应头信息：在控制器方法中添加dd(headers_list())，查看是否存在Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet响应头。缺失该头可能是中间件或服务器配置拦截了响应。
• 测试静态数据导出：将collection()方法改为返回静态集合return collect([['测试', '数据']]);，若能正常生成Excel，说明问题出在模型数据或关联查询上。

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