Laravel无第三方包导出千条+CSV数据，点击路由未下载仅显示内容

问题根源 #

1. 直接向php://output写入内容后返回空响应，导致CSV内容直接输出到页面而非作为附件下载
2. Content-Disposition头中的文件名使用了HTML实体"，而非原生引号，导致浏览器解析异常
3. 未处理输出缓冲，可能造成内容提前输出
4. 1000+数据使用all()会一次性加载所有记录到内存，存在性能隐患

修正后的控制器代码 #

use Illuminate\Support\Facades\Response;
use App\Models\DeviceStorage;

public function export()
{
    $csvFileName = 'min_value.csv';
    $headers = [
        'Content-Type' => 'text/csv',
        'Content-Disposition' => "attachment; filename=\"{$csvFileName}\"",
    ];

    // 使用游标查询处理大量数据，避免内存溢出
    $callback = function () {
        $handle = fopen('php://output', 'w');
        // 写入表头
        fputcsv($handle, ['device_id', 'device_name', 'min_sale_price']);

        // 游标遍历数据，逐条处理
        foreach (DeviceStorage::cursor() as $data) {
            fputcsv($handle, [
                $data->device_id,
                $data->Device->device_name,
                $data->min_sale_price
            ]);
        }

        fclose($handle);
    };

    return Response::stream($callback, 200, $headers);
}

额外优化建议 #

• 预加载关联关系：如果Device是关联模型，优化查询避免N+1问题，改为DeviceStorage::with('Device')->cursor()
• 禁用调试模式：开启调试模式时框架可能输出额外调试信息，干扰CSV内容，导出时可临时关闭调试
• 处理中文乱码：若包含中文，可在headers添加'Content-Encoding' => 'UTF-8'，并在fputcsv前写入BOM头：fprintf($handle, chr(0xEF).chr(0xBB).chr(0xBF));

路由与视图说明 #

当前路由和Blade文件的写法无需调整，保持原有代码即可。

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