Azure Function中multipart.Parse()触发JavaScript堆内存不足排查

核心问题分析 #

1. 消费计划内存限制瓶颈：你使用的Azure Function消费计划，默认实例内存上限为1.5GB（对应你看到的heap_size_limit:1660944384≈1.5GB）。虽然bufferBody仅约101MB，但parse-multipart库解析multipart数据时，会在内存中创建多个临时缓冲区（拆分分片、存储文件数据等），再加上Function运行时本身的内存开销，叠加后触发了内存溢出。
2. max-old-space-size修改无效：本地执行node --max-old-space-size=10000 index.js的设置无法同步到云端Function实例。云端Node.js参数需通过Function App的环境变量配置，且受限于消费计划实例的内存上限（最大1.5GB），设置超过实例内存的值没有实际意义。
3. 全量加载请求体到内存：你的代码将整个req.body转换成Buffer后再解析，这种方式会把文件一次性全量加载到内存，对大文件来说极易触发内存瓶颈。

解决方案 #

1. 改用流式解析与流式上传（推荐） #

使用支持流式处理的busboy库，直接将文件流上传到Blob Storage，避免全量加载到内存。示例代码如下：

const { BlobServiceClient } = require('@azure/storage-blob');
const busboy = require('busboy');
const AZURE_STORAGE_CONNECTION_STRING = process.env["AZURE_VIDEO_STORAGE_CONNECTION_STRING"];

module.exports = async function(context, req) {
    return new Promise((resolve, reject) => {
        const bb = busboy({ headers: req.headers });
        const blobServiceClient = BlobServiceClient.fromConnectionString(AZURE_STORAGE_CONNECTION_STRING);
        const containerClient = blobServiceClient.getContainerClient('feed-videos');

        bb.on('file', async (name, file, info) => {
            const { filename, mimeType } = info;
            const blockBlobClient = containerClient.getBlockBlobClient(filename);
            // 直接流式上传文件，无需全量加载到内存
            await blockBlobClient.uploadStream(file);
            context.res = {
                body: { name: filename, type: mimeType }
            };
            resolve();
        });

        bb.on('error', (err) => {
            context.log.error('文件解析错误:', err);
            context.res = { status: 500, body: '文件上传失败' };
            reject(err);
        });

        // 将请求流直接传给busboy解析
        req.pipe(bb);
    });
};

2. 调整云端Node.js内存参数（辅助） #

如果必须沿用原有解析方式，可通过Azure Portal配置Node.js内存参数：

• 进入你的Function App页面，选择配置 > 应用程序设置
• 添加环境变量WEBSITE_NODE_DEFAULT_ARGS，值设为--max-old-space-size=1536（对应1.5GB，匹配消费计划实例内存上限）
• 保存配置并重启Function App

3. 升级Function计划（可选） #

若流式处理仍无法满足需求，可考虑升级到高级计划或专用计划，这类计划提供更大内存的实例（最高达14GB），能更好地支撑大文件上传场景。

关键注意事项 #

• 消费计划实例内存上限为1.5GB，处理大文件必须避免全量加载到内存
• 流式处理是大文件上传的最优方案，可显著降低内存占用
• 本地测试的内存配置无法直接同步到云端，必须通过Azure Portal设置环境变量

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