Laravel Excel 3.1导出XLSX本地正常线上无法下载问题

这种线上环境导出不触发下载但文件已生成的问题我之前也碰到过，大概率是服务器环境或者响应头的问题，给你几个排查和解决方向：

1. 清空输出缓冲，确保响应及时发送 #

线上服务器通常会开启输出缓冲，导致Excel的下载响应被缓冲起来没有及时推送给浏览器。你可以在导出方法里手动清空缓冲：

public function export(){
    ob_clean(); // 清空当前输出缓冲
    ob_end_flush(); // 关闭缓冲并输出内容
    return Excel::download(new UsersExport, 'users.xlsx');
}

如果还是不行，可以检查服务器php.ini里的output_buffering配置，临时设置为Off或者调小缓冲大小，测试是否有效。

2. 检查临时文件的权限 #

文件能生成说明导出逻辑没问题，但Laravel可能无法读取生成的临时文件来发送给浏览器。检查storage/framework/laravel-excel目录的权限，确保web服务器用户（比如www-data、nginx）拥有读写权限：

chown -R www-data:www-data storage/framework/laravel-excel
chmod -R 755 storage/framework/laravel-excel

3. 手动设置响应头，避免服务器篡改 #

有些反向代理或服务器（比如Nginx）会修改或过滤响应头，导致浏览器识别不到下载指令。你可以绕开Excel::download的封装，直接返回文件内容并手动设置响应头：

public function export(){
    // 先获取Excel的原始内容
    $excelContent = Excel::raw(new UsersExport, \Maatwebsite\Excel\Excel::XLSX);
    
    // 手动构建响应
    return response($excelContent, 200)
        ->header('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
        ->header('Content-Disposition', 'attachment; filename="users.xlsx"')
        ->header('Cache-Control', 'no-cache');
}

4. 排查HTTPS/代理环境的头传递问题 #

如果线上是HTTPS环境或者使用了CDN/反向代理，要确保代理服务器完整传递了Content-Disposition等响应头。比如在Nginx的代理配置里添加：

proxy_set_header Content-Disposition $upstream_http_content_disposition;
proxy_set_header Content-Type $upstream_http_content_type;

我之前碰到的情况是输出缓冲导致的，加了ob_clean()就搞定了，你可以逐个测试这些方案，应该能解决问题。

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