Node.js嵌套Map中Promise异常：调试时跳至调用函数未执行返回

问题描述 #

运行嵌套循环的异步代码时，调试到const response = await client.send(command);语句后直接跳回调用函数，后续的return语句从未执行；但将代码移出嵌套Map、单独运行单例逻辑时功能正常，业务需要保留嵌套循环，无法移除。

原因分析 #

1. 外层循环未等待异步操作完成：templates.map()返回的是Promise数组，但外层没有用await Promise.all()包裹，导致整个循环逻辑不会等待内部所有异步任务完成就继续执行，看起来像是提前跳转。
2. 异常被静默吞掉：convertObjectToString函数的catch块只打印错误但没有重新抛出异常，导致上层代码无法感知到错误，调试时表现为直接跳过后续代码。
3. 异步Promise链断裂：嵌套的userJobs.map()虽然用了await Promise.all()，但外层的templates.map()没有被等待，整体异步流程没有形成完整的Promise链。

修复步骤 #

1. 修复外层循环的异步等待 #

将外层的templates.map()用await Promise.all()包裹，确保所有模板对应的异步任务都完成后再继续：

// 修改后的调用函数代码
await Promise.all(templates.map(async (template) => {
    await Promise.all(userJobs.map(async (job) => {
        if (job.emailAddress && job.emailAddress.length > 0) {
            if (job?.optedIn === null || job?.optedIn === undefined ||
                job?.optedIn === 1 || job?.optedIn === true) {
                if (job.templateAttributes && Object.keys(job.templateAttributes).length > 0) {
                    if (job.path) {
                        await setupTemplate({
                            firstName: job.firstName,
                            emailAddress: job.emailAddress,
                            templateAttributes: job.templateAttributes,
                            path: job.path
                        });
                    }
                }
            }
        }
    }));
}));

2. 修复异常处理，避免静默吞错 #

修改convertObjectToString的catch块，打印错误后重新抛出，让上层代码能捕获并处理异常：

// 修改后的convertObjectToString函数代码
try {
    const client = new S3Client({
        region:'us-west-1',
        credentials: {
            accessKeyId: process.env.ACCESS_KEY_ID,
            secretAccessKey: process.env.SECRET_ACCESS_KEY
        }
    });
    const command = new GetObjectCommand({
        Bucket: bucket,
        Key: key
    });

    const response = await client.send(command);
    return await response.Body.transformToString();
} catch (err) {
    console.error(err);
    throw err; // 重新抛出异常，让上层感知
} finally {
    console.log('Made it to the end');
}

3. （可选）优化嵌套循环的性能 #

如果userJobs数量较大，嵌套的Promise.all可能同时发起大量请求，可以考虑限制并发数（比如借助第三方工具p-limit），这属于性能优化，不影响基础功能修复。

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