javascript - 将大型 koa 请求正文上传到 AWS S3 的正确方法是什么？

Question

我正在构建一个应用程序后端。客户端将文件作为请求正文发布到服务器，然后服务器将文件上传到 AWS S3。服务器使用 NodeJS 和 koa Web 框架。

如果我使用raw-body来获取帖子正文进行缓冲，当文件很大时，缓冲区也很大，并导致内存不足错误。
如果我直接将 ctx.req(IncomingMessage 对象)传递给 S3.putObject，AWS SDK 会抛出错误，提示 无法确定 [object Object] 的长度，看起来 AWS SDK 尝试获取流的长度，然后开始分段上传。

AWS SDK 版本 2.383.0(当前最新)
NodeJS 10.14.2

此时，我编写了一个函数，从 IncomingMessage 作为流读取，等待数据事件填满一个大缓冲区(16MB)，然后将分段上传到 S3，这很好地解决了问题，但我仍在寻找更好的解决方案。

Answer 1

经过几个月的运行，我认为我的最终解决方案是稳定可靠的。

主要概念是从 IncomingMessage 流中接收数据并将其存储到缓冲区中，当缓冲区达到一定大小后，将当前部分放入 S3，然后继续读取流直到结束。

const uploaderLogger = Log4js.getLogger('customUploader');
function customMultiPartUpload(s3, bucket, key, incomingMessage, partSizeInByte) {
    return new Promise((resolve) => {
        partSizeInByte = partSizeInByte || uploadBufferMB * 1024 * 1024;
        uploaderLogger.debug(`part size is ${partSizeInByte}`);

        let uploadId = null;
        let partNumber = 0;
        let parts = [];
        let fileSize = 0;
        let reserveBuffer = Buffer.alloc(0);
        const sendBuffer = Buffer.alloc(partSizeInByte);
        const md5Hash = Crypto.createHash('md5');

        const doUpload = async (uploadBuffer) => {
            if (!uploadId) {
                uploaderLogger.debug('multipart upload not initialized');
                const createData = await s3.createMultipartUpload({
                    Bucket: bucket,
                    Key: key
                }).promise();
                uploadId = createData.UploadId;
                uploaderLogger.debug(`uploadId ${uploadId}`);

                partNumber = 0;
            }
            fileSize += uploadBuffer.length;
            uploaderLogger.debug(`buffer length ${uploadBuffer.length}, total ${fileSize}`);

            partNumber += 1;
            uploaderLogger.debug(`part number ${partNumber}`);

            md5Hash.update(uploadBuffer);

            const partData = await s3.uploadPart({
                Bucket: bucket,
                Key: key,
                PartNumber: partNumber,
                UploadId: uploadId,
                Body: uploadBuffer
            }).promise();
            parts.push({
                PartNumber: partNumber,
                ETag: partData.ETag
            });
            uploaderLogger.debug(`etag ${partData.ETag}`);
        };

        incomingMessage.on('data', async (chunkBuffer) => {
            incomingMessage.pause();

            reserveBuffer = Buffer.concat([ reserveBuffer, chunkBuffer ]);
            if (reserveBuffer.length > partSizeInByte) {
                do {
                    reserveBuffer.copy(sendBuffer, 0, 0, partSizeInByte);
                    reserveBuffer = reserveBuffer.slice(partSizeInByte);
                    await doUpload(sendBuffer);
                } while (reserveBuffer.length > partSizeInByte);
            }

            incomingMessage.resume();
        });

        incomingMessage.on('end', async () => {
            uploaderLogger.debug('stream end');

            if (reserveBuffer.length > 0) {
                await doUpload(reserveBuffer);
            }

            if (uploadId) {
                uploaderLogger.debug('uploadId not null');
                await s3.completeMultipartUpload({
                    Bucket: bucket,
                    Key: key,
                    UploadId: uploadId,
                    MultipartUpload: {
                        Parts: parts
                    }
                }).promise();
                uploaderLogger.debug('multipart upload complete');
            }

            const hash = md5Hash.digest('hex');

            resolve({
                size: fileSize,
                hash: hash
            });
            uploaderLogger.debug(`return file size ${fileSize}, hash ${hash}`);
        });
    });
}

调整 partSizeInByte 以适应您的服务器内存使用情况，太大的部件大小可能会在服务器处理大量请求时导致 OOM，太小的部件大小可能会小于 S3 部件限制。