Zip文件无法创建与下载问题：仅返回文件名的技术排查

我帮你排查了代码里的几个关键问题，这些问题直接导致Zip文件无法正确创建和下载：

核心错误点： #

• Content-Type设置错误：你把MIME类型设成了application/json，但Zip文件对应的正确类型是application/zip，浏览器会依赖这个标识来识别文件格式
• Content-Length计算错误：你用mb_strlen($filename)获取的是文件名的字符长度，而非文件的实际字节大小，正确的做法是用filesize($filename)获取文件真实大小
• 多余的输出内容：你在readfile之前echo了$filename，这会把文件名字符串插入到响应内容的开头，直接破坏了Zip文件的完整性
• Header冗余与顺序问题：部分Cache-Control设置重复，且flush操作的时机可以优化

修正后的代码： #

if (file_exists($filename)) { 
    // 先检查文件是否可读
    if (!is_readable($filename)) {
        header("HTTP/1.1 403 Forbidden");
        exit("无法读取指定的Zip文件");
    }

    // 设置正确的响应头
    header("HTTP/1.1 200 OK"); 
    header("Pragma: public"); 
    header("Cache-Control: must-revalidate, post-check=0, pre-check=0"); 
    header("Cache-Control: private", false); 
    $mimeType = 'application/zip'; // 修正为Zip对应的MIME类型
    header("Content-type: " . $mimeType); 
    // 用basename确保只传递纯文件名，避免路径干扰浏览器识别
    header("Content-Disposition: attachment; filename=\"" . basename($filename) . "\""); 
    header("Content-Transfer-Encoding: binary"); 
    header("Content-Length: " . filesize($filename)); // 使用文件实际字节大小

    // 清空输出缓冲区，避免之前的冗余输出污染文件内容
    ob_clean();
    flush();

    // 读取并输出文件内容
    readfile($filename); 

    // 确保文件输出完成后再删除
    unlink($filename); 
    exit;
} else {
    header("HTTP/1.1 404 Not Found");
    exit("指定的Zip文件不存在");
}

额外优化说明： #

• 新增了is_readable检查，避免文件存在但无读取权限的情况
• 用basename($filename)提取纯文件名，防止文件名包含路径导致浏览器处理异常
• 添加ob_clean()清空缓冲区，避免之前的输出内容破坏Zip文件结构
• 末尾增加exit确保后续无多余代码执行

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