核心陷阱是php默认将大csv全量加载进内存触发oom，而非gridfs驱动问题；必须用fopen('rb')直连uploadfromstream、设stream_set_chunk_size、校验文件大小并清理孤儿块。
PHP 8 中用 MongoDB 扩展上传大 CSV 到 GridFS，核心陷阱不是驱动不支持，而是默认用 $file->getStream() 或 file_get_contents() 加载全量内容进内存——一个 500MB CSV 直接触发 PHP 的 memory_limit 溢出或 OOM，GridFS 还没开始写就崩了。
为什么 move_uploaded_file() + uploadFromStream() 仍会爆内存
很多人以为把临时文件用 move_uploaded_file() 落盘后，再传给 uploadFromStream() 就安全了，其实不然：
- 若你用
fopen($tmpPath, 'r')再手动fread()拼成字符串或stream_get_contents()，整个文件又进了 PHP 用户空间内存 -
uploadFromStream()接收的是 PHP stream resource，但如果你中间加了stream_filter_append()（比如转编码）且没设read_buffer，它可能缓存整块数据 - PHP 8.1+ 默认启用
zend.enable_gc=1，但大 buffer 仍会拖慢 GC，表现为上传中途 CPU 飙高、超时
必须用 fopen() 配 stream_set_chunk_size() 直连 GridFS 流
正确做法是跳过任何中间读取，让文件句柄直通 GridFS 的写入流：
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
- 调用
fopen($tmpPath, 'rb')获取只读资源，**不要**fread()或stream_get_contents() - 立即执行
stream_set_chunk_size($fp, 64 * 1024)，控制每次从磁盘读取的粒度，避免内核缓冲区堆积 - 传给
$bucket->uploadFromStream($filename, $fp, ['chunkSizeBytes' => 1024 * 1024])—— 注意单位是字节，1024 * 1024是 1MB，比默认 255KB 更适合 CSV 这类顺序文本 - 上传前务必校验
$_FILES['csv']['size']，超限直接http_response_code(413)拒绝，别让请求体进 PHP
上传中断后如何清理残留的 fs.files 和 fs.chunks
PHP 里没自动回滚机制，网络抖动或用户取消会导致 fs.files 文档已插入但 fs.chunks 只写了一半——这些“孤儿块”不会被自动删除，下次同名上传会失败或覆盖元数据但留着脏 chunk：
- 上传前生成唯一
$uploadId = bin2hex(random_bytes(16))，写入metadata.uploadId字段 - 上传失败时，用
$bucket->getFilesCollection()->deleteMany(['metadata.uploadId' => $uploadId])先清fs.files - 再用
$bucket->getChunksCollection()->deleteMany(['files_id' => ['$in' => $fileIds]])清 chunk，其中$fileIds是上一步刚删掉的文档_id数组 - 别用
find()+ 循环deleteOne()，批量删更可靠；清完记得gc_collect_cycles()释放 PHP 引用
为什么不能用 uploadFromBuffer() 处理大 CSV
uploadFromBuffer() 看似方便，但它内部会把整个 buffer 复制进 BSON 编码流程，对 CSV 这种纯文本毫无压缩收益，反而放大内存压力：
- 假设 CSV 是 800MB，
uploadFromBuffer()至少要两倍内存：一份原始 buffer，一份编码后的 BSON chunk buffer - PHP 8 的
memory_limit默认 128M，即使调到 2G，V8 引擎（如果混用 Node.js 中间层）或 MongoDB 驱动的 C 层 buffer 也可能先扛不住 - 该函数本质是为小配置文件、图标等设计的，不是为批量数据流准备的
- 真正需要 buffer 场景（如加密后上传），应自己分块读 +
uploadStream->write()，而非一股脑塞进去
最关键的细节常被忽略：PHP 的 max_execution_time 和 MongoDB 驱动的 socket timeout 是两套机制，必须同时调大。光设 set_time_limit(0) 不行，还得在连接选项里加 'socketTimeoutMS' => 300000，否则上传到一半驱动主动断连，你根本收不到 error 事件。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
