CodeIgniter项目CSV导出异常：仅打开新标签页无文件下载

核心排查方向 #

1. 响应头设置错误 #

CSV下载依赖正确的HTTP响应头，若未设置或设置顺序错误，浏览器会将内容当作普通页面渲染而非触发文件下载。

正确的头设置示例：

// 必须在输出任何内容前设置
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="导出数据.csv"');

注意：头设置必须放在echo、fputcsv等输出操作之前，且不能有任何前置输出（包括空格、空行）。

2. 存在多余输出 #

如果控制器、模型或PHP文件的开头/结尾有空格、空行，或者残留了var_dump、echo等调试代码，会导致HTTP头无法正常发送，浏览器只能打开新标签显示内容。

排查点：

• 检查所有相关PHP文件的<?php标签前、?>标签后是否有空格或空行（建议直接去掉闭合标签?>）
• 确保导出函数中没有未注释的调试输出

3. 脚本未正确终止 #

CodeIgniter默认会在控制器函数执行完后加载视图或输出其他内容，这会打断CSV输出流程。必须在CSV输出完成后立即终止脚本：

fclose($output);
exit; // 或die();

4. 前端触发方式问题 #

• 若使用<a href="xxx/csvExport" target="_blank">，浏览器会将请求当作普通页面打开，改为直接跳转（去掉target="_blank"）即可触发下载。
• 若使用AJAX请求，默认无法直接触发下载，需通过Blob对象处理：

// 原生JS示例
fetch('xxx/csvExport')
.then(response => response.blob())
.then(blob => {
    const url = URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = '导出数据.csv';
    a.click();
    URL.revokeObjectURL(url);
});

完整控制器示例代码 #

public function csvExport()
{
    // 清空输出缓冲，避免前置输出干扰
    ob_clean();
    ob_start();

    // 获取模型数据（已确认数据正常）
    $exportData = $this->your_model->excel_data();
    if (empty($exportData)) {
        echo '无数据可导出';
        exit;
    }

    // 设置文件名
    $filename = '数据导出_' . date('YmdHis') . '.csv';

    // 发送响应头
    header('Content-Type: text/csv; charset=utf-8');
    header('Content-Disposition: attachment; filename="' . $filename . '"');

    // 输出CSV内容
    $output = fopen('php://output', 'w');
    // 写入表头（假设数据为关联数组）
    fputcsv($output, array_keys($exportData[0]));
    // 写入数据行
    foreach ($exportData as $row) {
        fputcsv($output, $row);
    }

    fclose($output);
    // 终止脚本，禁止后续输出
    exit;
}

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