PHP：PDO导出CSV无法下载（疑似Header问题？）

我来帮你排查下这个CSV导出的问题，你遇到的浏览器不弹出下载窗口，大概率是Header配置或者输出逻辑的问题，咱们一步步来修复：

几个关键问题点 #

• Header必须在所有输出之前发送：如果调用downloadAsCSV函数之前有任何输出（比如空格、HTML代码、甚至PHP文件开头的BOM头），都会导致Header失效，浏览器无法识别下载请求。一定要确保函数执行前没有任何输出。
• Content-Disposition格式错误：你代码里的filename='export.csv'带了单引号，标准写法应该去掉单引号，或者用双引号包裹（适合含特殊字符的文件名），改成filename="export.csv"更规范。
• 表头与数据顺序颠倒：你先写入了第一行数据，再写表头，这会让CSV的表头跑到第二行，不符合常规导出逻辑，得调整顺序。
• 空结果的边界处理：如果查询没有返回任何数据，$first_row = $stmt->fetch(PDO::FETCH_ASSOC)会返回false，后续代码会报错，需要加判断。
• 无用的mysqli函数：你定义的mysqli_field_name根本没用到，既然用PDO，直接删掉就行，避免混淆。

修正后的完整函数代码 #

function downloadAsCSV($dsn, $dbUser, $dbPsw, $options) {
    // 检查是否已有前置输出，提前报错排查问题
    if (headers_sent()) {
        die("无法触发下载：已有前置输出，请检查代码是否有多余空格/HTML输出");
    }

    // 建立PDO连接
    $pdo = pdoConnect($dsn, $dbUser, $dbPsw, $options);
    $query = "..."; // 替换为你的实际查询语句

    // 执行查询
    $stmt = $pdo->prepare($query);
    // 设置查询参数（如果需要）
    // $stmt->bindParam(':param', $value);
    $stmt->execute();

    // 发送标准下载Header
    header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
    header('Content-Description: File Transfer');
    header("Content-Type: text/csv; charset=utf-8"); // 加入编码避免中文乱码
    header("Content-Disposition: attachment; filename=\"export.csv\"");
    header("Pragma: no-cache");
    header("Expires: 0");

    // 打开输出流
    $fp = fopen("php://output", "w");
    if ($fp) {
        // 获取第一行数据并处理表头
        $first_row = $stmt->fetch(PDO::FETCH_ASSOC);
        if ($first_row) {
            // 先写入表头
            $headers = array_keys($first_row);
            fputcsv($fp, $headers);
            // 再写入第一行数据
            fputcsv($fp, array_values($first_row));
            
            // 循环写入剩余数据
            while ($workpiece = $stmt->fetch(PDO::FETCH_ASSOC)) {
                fputcsv($fp, array_values($workpiece));
            }
        }
        fclose($fp);
    }

    // 清理数据库资源
    $stmt = null;
    $pdo = null;
    exit; // 终止后续所有输出，确保只有CSV内容发送到浏览器
}

额外建议 #

• 加入charset=utf-8可以避免导出的CSV出现中文乱码问题；
• 最后加上exit;能防止后续代码输出多余内容，破坏CSV文件格式；
• headers_sent()检查可以快速帮你定位是否有前置输出导致Header失效的问题。

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