PHP上传文件下载后损坏及download.php代码错误求助

一、先解决致命错误：Undefined array key "file_path" & 路径为空 #

这个错误是导致文件下载损坏的核心原因——错误信息会被输出到下载响应中，破坏文件结构（二进制文件如Excel会直接损坏，文本文件能看到错误内容）。

排查点： #

• 数组键名不匹配：检查download.php中获取file_path的逻辑，比如是不是从$_GET['file']取但代码里写了$_GET['file_path']，或者数据库表中根本没有file_path字段（比如你上传时只存了重命名后的文件名，没存完整路径）。
• 参数传递缺失：前端跳转下载时，有没有正确传递文件标识参数（比如文件ID、文件名）？如果参数没传，后端自然拿不到有效路径。
• 未做存在性判断：直接访问数组键之前没做isset()或empty()校验，比如直接写$file_path = $_GET['file_path']，但这个参数根本不存在。

修复示例： #

假设你数据库中存的是重命名后的文件名（字段名saved_name），通过文件ID查询：

<?php
// 连接数据库（替换为你的配置）
$conn = mysqli_connect('localhost', 'db_user', 'db_pass', 'db_name');

// 校验参数：必须传文件ID
$file_id = $_GET['id'] ?? null;
if (!$file_id || !is_numeric($file_id)) {
    die("无效的文件请求");
}

// 查询数据库获取文件名
$stmt = mysqli_prepare($conn, "SELECT saved_name, original_name FROM files WHERE id = ?");
mysqli_stmt_bind_param($stmt, "i", $file_id);
mysqli_stmt_execute($stmt);
$result = mysqli_stmt_get_result($stmt);
$file_data = mysqli_fetch_assoc($result);

if (!$file_data) {
    die("文件不存在");
}

// 拼接完整文件路径
$file_path = './uploads/' . $file_data['saved_name'];
if (!file_exists($file_path)) {
    die("文件已被删除");
}

二、解决文件下载损坏问题 #

修复致命错误后，还要确保下载脚本的响应输出干净，没有多余内容：

排查点： #

• 多余空白输出：检查download.php中PHP标签前后的空格、换行，比如<?php前面有空格，或者?>后面有换行，这些都会被输出到响应头之后，破坏文件结构（建议直接省略?>）。
• 响应头设置错误：没有设置正确的Content-Type和Content-Length，导致浏览器无法正确解析文件。
• 调试输出残留：代码中有没有echo、var_dump之类的调试语句，这些内容会混入文件内容中。

修复示例（完整下载逻辑）： #

<?php
// 注意：这里前面不能有任何空格、换行或HTML内容
$conn = mysqli_connect('localhost', 'db_user', 'db_pass', 'db_name');

// （上面的参数校验、数据库查询逻辑）

// 设置正确的下载响应头
header('Content-Type: application/octet-stream');
// 用原文件名作为下载文件名，避免乱码
header('Content-Disposition: attachment; filename="' . rawurlencode($file_data['original_name']) . '"');
// 告诉浏览器文件实际大小，避免截断
header('Content-Length: ' . filesize($file_path));
// 禁止缓存，确保每次下载都是最新文件
header('Cache-Control: no-cache, no-store, must-revalidate');
header('Pragma: no-cache');
header('Expires: 0');

// 输出文件内容并终止脚本
readfile($file_path);
exit;
// 这里不要加?>，避免后续空白输出

三、关键总结 #

1. 文件损坏本质是下载响应中混入了错误信息或多余空白，破坏了文件的二进制结构；
2. "Undefined array key 'file_path'" 是因为脚本直接访问了未定义的数组键，或者数据库查询结果中没有对应字段，必须先校验参数和查询结果的有效性；
3. 即使删除了.htaccess，只要脚本输出有问题，文件还是会损坏，核心问题在download.php的逻辑而非目录权限。

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