NodeJS应用中async.parallel在EJS与Ionic JWT API端执行顺序异常问题

看起来你遇到的核心问题是：同一个async.parallel逻辑在浏览器通过CSRF会话访问时正常，但Ionic携带JWT调用API时无法按预期执行。结合你给出的代码片段，我来帮你拆解可能的原因和解决办法：

可能的原因分析 #

1. req.decoded的异步加载时序问题
   你的第二个并行函数依赖req.decoded，这应该是JWT中间件解析后挂载到请求对象上的内容。如果JWT中间件包含异步操作（比如从数据库拉取用户信息补充到decoded中），但没有等异步操作完成就调用了next()，那async.parallel启动时req.decoded可能还未准备好，导致第二个函数逻辑异常，进而阻塞整个并行流程。
   而浏览器会话模式下，用户信息通常是从session同步读取的，不存在这个时序差问题。

2. 第一个并行任务的回调未正确触发
   你代码里第一个任务是buildAlertButtonsArray.getRealTestAlerts(req, function(arrayAlerts) { ... })，如果这个方法在JWT认证场景下（比如req参数和Web端存在差异）出现内部错误，但没有捕获错误并调用callback(err)，只处理了成功分支的callback(null, arrayAlerts)，那一旦方法内部出错，就会导致整个async.parallel挂起，永远等不到回调信号。

3. 环境或库版本的隐性差异
   虽然概率较低，但Web端和Ionic调用时的NodeJS运行环境如果存在async库版本不一致的情况，可能触发兼容性问题，导致并行任务的执行逻辑偏离预期。

针对性解决方案 #

1. 确保JWT中间件的异步操作完成后再进入业务逻辑 #

检查你的JWT中间件代码，保证所有异步操作完成后才调用next()，这样到async.parallel执行时，req.decoded已经完全就绪：

// 正确示例：等待异步查询完成后再调用next()
app.use((req, res, next) => {
  const token = req.headers.authorization?.split(' ')[1];
  jwt.verify(token, secret, (err, decoded) => {
    if (err) return next(err);
    // 异步拉取用户信息补充decoded
    User.findById(decoded.userId, (err, user) => {
      if (err) return next(err);
      req.decoded = { ...decoded, userInfo: user };
      next(); // 异步操作完成后再进入下一个中间件/业务逻辑
    });
  });
});

2. 给并行任务添加完整的错误捕获逻辑 #

修改第一个并行任务的代码，确保无论成功还是失败都调用回调函数，避免流程挂起：

function(callback){
  buildAlertButtonsArray.getRealTestAlerts(req, 
    function(arrayAlerts) {
      console.log('2');
      callback(null, arrayAlerts);
    }, 
    function(err) {
      // 增加错误回调分支（如果getRealTestAlerts支持的话）
      console.error('getRealTestAlerts执行出错:', err);
      callback(err);
    }
  );
  // 如果getRealTestAlerts只有单个回调，要在其内部做好错误捕获：
  // 比如在getRealTestAlerts方法里用try-catch包裹逻辑，出错时调用callback(err)
}

同时，给async.parallel的最终回调添加错误处理，方便排查问题：

async.parallel([
  // 你的两个并行任务
], function(err, results) {
  if (err) {
    console.error('parallel执行失败:', err);
    return res.status(500).json({ error: err.message });
  }
  // 正常处理并行任务的结果
});

3. 对比两种场景下的req对象差异 #

在console.log('1')后添加日志，对比Web端和Ionic调用时req.decoded的状态：

console.log('1');
console.log('当前req.decoded:', req.decoded); // 新增日志
async.parallel([
  // ...你的任务
]);

如果Ionic调用时req.decoded为undefined或内容不完整，那就是JWT中间件的问题，需要排查token是否正确传递、中间件是否正确挂载到API路由上。

4. 改用原生Promise.all替代async.parallel（推荐） #

如果你的NodeJS版本较新，建议用原生Promise.all替代async.parallel，Promise的错误处理更清晰，也更符合现代JavaScript的写法：

console.log('1');
Promise.all([
  // 把第一个回调式方法包装成Promise
  new Promise((resolve, reject) => {
    buildAlertButtonsArray.getRealTestAlerts(req, 
      (arrayAlerts) => {
        console.log('2');
        resolve(arrayAlerts);
      },
      (err) => reject(err)
    );
  }),
  // 第二个任务包装成Promise
  new Promise((resolve, reject) => {
    if (!req.decoded) {
      return reject(new Error('req.decoded未就绪'));
    }
    // 执行第二个任务的逻辑
    resolve(/* 第二个任务的结果 */);
  })
]).then(results => {
  // 处理两个任务的结果：results[0]是第一个任务的返回值，results[1]是第二个的
}).catch(err => {
  console.error('并行任务执行出错:', err);
  res.status(500).json({ error: err.message });
});

验证步骤 #

1. 先通过日志对比两种场景下req.decoded的状态，确认JWT解析是否正常完成；
2. 给async.parallel的最终回调添加错误日志，排查是否有未捕获的错误；
3. 检查第一个并行任务的内部逻辑，确保没有遗漏错误处理导致回调不触发。

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