Laravel导出Excel视图问题：点击下载按钮无响应求排查

问题描述 #

我按照教程和Laravel-Excel包在Laravel项目中实现Excel数据导出功能，但点击下载按钮后无任何反应。已尝试修改按钮类型，附上相关代码文件，恳请帮忙排查问题：

相关代码文件 #

app\Exports\UsersDataExport

namespace App\Exports;
use Illuminate\Contracts\View\View;
use App\Models\User;
use Maatwebsite\Excel\Concerns\FromCollection;
use Maatwebsite\Excel\Concerns\Exportable;
use Maatwebsite\Excel\Concerns\FromView;
use Maatwebsite\Excel\Concerns\ShouldAutoSize;

class UsersDataExport implements FromView,ShouldAutoSize
{
    use Exportable;
    private $users;

    function __construct()
    {
        $this->users = User::all();
    }

    public function view() : View
    {
        return view('excel.usersdetails', [
            'users' => $this->users
        ]);
    }
}

app\Http\Controllers\HomeController

use App\Exports\UsersDataExport;
use Maatwebsite\Excel\Facades\Excel;

public function exportExcel()
{
    return Excel::download(new UsersDataExport, 'users-data.xlsx');
}

routes\web.php

Route::post('users/export-excel', [HomeController::class, 'exportExcel'])->name('users.download-excel');

resources\views\index.blade.php

<div>
 <form action="{{ route('users.download-excel') }}" method="POST" target="_blank">
  @csrf
   <div>
   <button type="button" class="btn btn-success" value="button">Excel</button>
   </div>
 </form>
  </div>

resources\views\excel\usersdetails.blade.php

<body>
    <table style="position: relative; top: 50px">
        <thead>
            <tr>
                <th>nom et prenom du destinaire</th>
                <th>telephone</th>
                <th>code wilaya</th>
                <th>commune de livraison</th>
                <th>adresse de livraison</th>
                <th>montant du colis</th>
            </tr>
        </thead>
        <tbody>
            @foreach($users as $user)
            <tr>
                <td data-column="nom et prenom du destinaire">John Doe</td>
                <td data-column="telephone">000</td>
                <td data-column="code wilaya">56</td>
                <td data-column="commune de livraison">11</td>
                <td data-column="adresse de livraison">AAA</td>
                <td data-column="montant du colis">100</td>
            </tr>
            @endforeach
        
        </tbody>
    </table>

    <script src="js/main.js"></script>
</body>

排查与修复步骤 #

1. 修复表单提交按钮类型 #

当前按钮类型为type="button"，这类按钮仅用于触发JavaScript事件，不会自动提交表单。将其改为type="submit"才能触发表单提交，调用导出接口：

<button type="submit" class="btn btn-success">Excel</button>

2. 检查控制器命名与文件路径 #

代码中提到的app\Http\HomeControllers应为app\Http\Controllers\HomeController（单数形式），确保文件名、类名与路由中的引用完全一致，避免类找不到的错误。

3. 验证路由可访问性 #

可以通过Postman或其他工具发送POST请求到/users/export-excel，携带_token参数，测试是否能正常返回Excel文件。如果请求报错，检查路由是否被中间件限制，或命名空间配置是否正确。

4. 优化导出类逻辑（可选） #

将用户查询逻辑从构造方法移至view方法，避免过早执行数据库查询：

class UsersDataExport implements FromView, ShouldAutoSize
{
    use Exportable;

    public function view(): View
    {
        return view('excel.usersdetails', [
            'users' => User::all()
        ]);
    }
}

5. 清理导出视图冗余内容 #

Laravel-Excel仅需要表格的HTML结构，导出视图中的<body>标签和JS引用属于冗余内容，可能导致导出文件异常，建议修改为：

<table style="position: relative; top: 50px">
    <thead>
        <tr>
            <th>收件人姓名</th>
            <th>电话</th>
            <th>省份代码</th>
            <th>配送区域</th>
            <th>配送地址</th>
            <th>包裹金额</th>
        </tr>
    </thead>
    <tbody>
        @foreach($users as $user)
        <tr>
            <td data-column="收件人姓名">{{ $user->name }}</td> <!-- 替换为User模型实际字段，不要硬编码固定值 -->
            <td data-column="电话">{{ $user->phone ?? '无' }}</td>
            <td data-column="省份代码">56</td>
            <td data-column="配送区域">11</td>
            <td data-column="配送地址">AAA</td>
            <td data-column="包裹金额">100</td>
        </tr>
        @endforeach
    </tbody>
</table>

6. 确认Laravel-Excel安装正确性 #

确保已执行composer require maatwebsite/excel完成包安装，且Laravel版本与包版本兼容。若使用Laravel 9+，需确认包版本为3.1及以上。

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