PHP环境下无法访问MongoDB中GridFS存储的文件问题求助

作为刚接触流和GridFS的开发者，你的问题核心其实是上传环节逻辑错误导致后续下载找不到有效文件，再加上下载页面没有正确输出内容给浏览器，才出现空白页。咱们一步步来修复：

一、先解决上传环节的致命错误 #

你的上传代码把GridFS的流操作搞混了，这直接导致存储的pdf字段不是有效的文件ID，后续自然下载失败。看这段有问题的代码：

if ($_FILES['pdf']) {
    $stream = $bucket->openUploadStream($_FILES['pdf']['tmp_name']);
    $document['pdf'] = $bucket->uploadFromStream($_FILES['pdf']['name'], $stream);
}

错误点：

• openUploadStream是创建写入GridFS的流，而uploadFromStream需要的是读取本地文件的源流，你把两者混用了
• 没有检查文件是否上传成功（比如是否存在上传错误）

修复后的上传代码：

// 先检查文件是否正常上传
if (isset($_FILES['pdf']) && $_FILES['pdf']['error'] === UPLOAD_ERR_OK) {
    // 用uploadFromFile直接从临时文件上传，更简洁不易出错
    $fileId = $bucket->uploadFromFile(
        $_FILES['pdf']['name'], // 存储到GridFS的文件名
        ['source' => $_FILES['pdf']['tmp_name']] // 本地临时文件路径
    );
    // 把GridFS返回的有效文件ID存在document的pdf字段
    $document['pdf'] = $fileId;
}

这样上传后，$document['pdf']就是MongoDB中fs.files集合对应的_id，后续下载时能精准定位文件。

二、修复下载页面（file.php）的空白问题 #

你的file.php只获取了文件内容，但没有把内容输出给浏览器，也没设置响应头告诉浏览器这是PDF文件，所以浏览器收到空白内容后显示空白页。

修复后的file.php代码：

<?php
require 'vendor/autoload.php';

try {
    // 保持数据库连接和主页面一致，避免混淆
    $mng = new MongoDB\Driver\Manager("mongodb://localhost:27017/dbname");
    $bucket = new MongoDB\GridFS\Bucket($mng, 'dbname');

    // 先检查请求ID是否合法
    if (!isset($_GET['id']) || !MongoDB\BSON\ObjectID::isValid($_GET['id'])) {
        http_response_code(400);
        echo "无效的文件ID";
        exit;
    }

    $fileId = new MongoDB\BSON\ObjectID($_GET['id']);
    
    // 先确认文件存在，避免报错
    $fileMeta = $bucket->find(['_id' => $fileId])->toArray();
    if (empty($fileMeta)) {
        http_response_code(404);
        echo "文件不存在";
        exit;
    }
    $originalName = $fileMeta[0]['filename'];

    // 设置HTTP响应头，让浏览器识别这是PDF文件
    header('Content-Type: application/pdf');
    // 想在线查看用inline，想直接下载用attachment
    header('Content-Disposition: inline; filename="' . $originalName . '"');
    header('Content-Length: ' . $fileMeta[0]['length']);

    // 直接输出流内容，大文件也不会占内存
    $stream = $bucket->openDownloadStream($fileId);
    fpassthru($stream);
    exit;

} catch (Exception $e) {
    http_response_code(500);
    echo '服务器错误: ',$e->getMessage(),"\n";
}
?>

关键改进：

1. 增加了ID合法性和文件存在性检查，避免无效请求
2. 设置了正确的响应头，让浏览器知道如何处理PDF内容
3. 用fpassthru直接输出流，比先把内容读到内存更高效
4. 异常处理时返回对应HTTP状态码，方便排查问题

三、额外排查点 #

• 数据库名称一致性：确保主页面和file.php里的数据库名称完全相同（比如都是dbname）
• ID传递正确性：在主页面里打印echo $document->pdf;，确认它和MongoDB Compass中fs.files的_id字符串完全一致
• 权限问题：确保PHP有读取临时上传文件的权限，以及MongoDB的读写权限正常

按照上面的步骤修复后，就能正常上传和下载PDF文件了。

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