是，必须装maatwebsite/excel——laravel-admin自身无excel导出能力，所有导出按钮均依赖该扩展；未安装或注册错误会导致点击无反应、报class 'maatwebsite\excel\facades\excel' not found或500错误。
laravel-admin 导出功能没反应，是不是漏装 maatwebsite/excel？
不是“可能漏装”，是**必须装**——laravel-admin 本身不带 Excel 导出能力，所有 export 按钮（包括列表页的「导出 Excel」）都依赖 maatwebsite/excel 提供底层支持。2023 年后新项目默认用的是 phpoffice/phpspreadsheet，而 maatwebsite/excel v3+ 就是它的封装层。
常见现象：点击导出按钮页面刷新、无下载、控制台报 Class 'Maatwebsite\Excel\Facades\Excel' not found 或 500 错误，基本可直接锁定为扩展未安装或未正确注册。
- 确认是否已运行：
composer require maatwebsite/excel - Laravel 10+ 无需手动注册 Facade，但需检查
config/app.php中是否残留旧版'Excel' => Maatwebsite\Excel\Facades\Excel::class—— 这行要删掉，否则会冲突 - 执行
php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider" --tag=config生成配置，再检查config/excel.php是否存在
导出按钮点了没反应，laravel-admin 的 grid->export() 配置对不对？
laravel-admin 的导出不是开箱即用的自动行为，它只在你显式调用 export() 且模型/数据源支持时才生效。最容易被忽略的是：**导出动作默认绑定到 Model 的 newQuery()，而不是当前 Grid 的筛选结果**。
如果你加了搜索条件或过滤器，但导出仍是全量数据，大概率是因为没把查询逻辑同步给导出器。
- 确保在
Grid构造后立即调用：$grid->export()->except(['id', 'created_at']) - 如需导出当前筛选结果，必须重写
getExportData()方法，或使用$grid->model()->withFilters($grid->getFilter()->getInputs())显式传递过滤参数 - 导出列名映射靠
$grid->column('name')->export(function ($value) { return $value; })，不设这个，中文字段可能乱码或空值
导出 CSV 正常，但 XLSX 报错 ZipArchive::open(): Failed to open stream
这是 phpspreadsheet 底层依赖 ext-zip 扩展导致的典型环境问题。XLSX 格式本质是 ZIP 包，没启用 zip 扩展就必然失败，而 CSV 是纯文本，不依赖它。
- 运行
php -m | grep zip确认扩展已加载；若无，Ubuntu/Debian 上执行sudo apt install php-zip，然后重启 PHP-FPM 或 Apache - Windows 用户注意：PHP.ini 中需取消注释
extension=zip，且确保php_zip.dll文件存在 - 即使 zip 扩展存在，也需检查
config/excel.php中'memory_limit' => -1和'temp_path' => sys_get_temp_dir()是否可写，否则仍会静默失败
导出大表卡死或超时，怎么调优？
laravel-admin 默认把全部数据查出来再交给 Excel 处理，1 万行以上就容易 OOM 或超时。这不是前端按钮的问题，而是服务端数据加载策略没改。
- 禁用自动分页导出（默认开启）：
$grid->disableExport(false)不起作用，真正有效的是在Grid初始化前加Grid::$useExportQuery = false，然后自己实现流式导出 - 更稳妥的做法：改用
Maatwebsite\Excel\Concerns\FromQuery+WithChunkReading，绕过 laravel-admin 的导出钩子，单独写一个ExportController - 务必设置
ini_set('memory_limit', '1G')和set_time_limit(0)（仅限 CLI 或可信后台请求），生产环境建议加队列异步导出
最易被忽略的一点：laravel-admin 的导出入口其实是 GET /admin/export?_token=xxx&grid=xxx，它走的是 Web 请求生命周期，没法像 Artisan 命令那样稳定处理大数据。真要导出上万行，别硬扛，拆出去用队列。
