Node.js开发Firebase Cloud Functions时，控制台出现Promise { pending }问题求助

我之前也踩过这个坑！控制台显示Promise { pending }通常不是因为你用错了.then()，而是Firebase的函数运行时没正确追踪到你的异步操作状态。下面是几个最常见的原因和修复方法：

1. 忘记把Promise返回给函数运行时 #

Cloud Functions需要明确知道你的异步操作什么时候完成——如果你在函数里发起了异步调用，但没把对应的Promise返回给它，运行时会直接结束函数执行，留下还在pending的Promise，控制台就会输出这个提示。

错误示例：

exports.fetchData = functions.https.onRequest((req, res) => {
  // 发起异步请求，但没返回Promise
  admin.firestore().collection('data').get().then(snapshot => {
    res.send(snapshot.docs.map(doc => doc.data()));
  });
});

修复后：

exports.fetchData = functions.https.onRequest((req, res) => {
  // 把Promise返回给运行时，让它等待操作完成
  return admin.firestore().collection('data').get().then(snapshot => {
    res.send(snapshot.docs.map(doc => doc.data()));
  }).catch(error => {
    res.status(500).send(`获取数据失败: ${error.message}`);
  });
});

或者用async/await写更清晰：

exports.fetchData = functions.https.onRequest(async (req, res) => {
  try {
    const snapshot = await admin.firestore().collection('data').get();
    res.send(snapshot.docs.map(doc => doc.data()));
  } catch (error) {
    res.status(500).send(`获取数据失败: ${error.message}`);
  }
});

2. 嵌套Promise时遗漏返回内部Promise #

如果在.then()回调里又发起了另一个异步操作，一定要把这个内部的Promise返回出去，否则外层的Promise会提前resolve，导致内部操作还在pending状态。

错误示例：

exports.updateAndNotify = functions.https.onRequest((req, res) => {
  return admin.firestore().doc('users/123').update({name: 'New Name'}).then(() => {
    // 这里发起了异步通知，但没返回Promise
    sendNotificationToUser('123');
  }).then(() => {
    res.send('操作完成');
  });
});

修复后：

exports.updateAndNotify = functions.https.onRequest((req, res) => {
  return admin.firestore().doc('users/123').update({name: 'New Name'}).then(() => {
    // 返回内部Promise，让链式调用等待它完成
    return sendNotificationToUser('123');
  }).then(() => {
    res.send('操作完成');
  });
});

3. 未处理Promise的reject状态 #

如果你的Promise被reject了，但没有添加.catch()处理，Firebase运行时可能无法正确捕获这个错误，导致Promise看起来一直处于pending状态。一定要加上错误处理逻辑，避免未捕获的rejection。

示例（带错误处理）：

exports.deleteUser = functions.https.onRequest((req, res) => {
  return admin.auth().deleteUser(req.body.uid)
    .then(() => res.send('用户删除成功'))
    .catch(error => {
      console.error('删除用户失败:', error);
      res.status(400).send(`删除失败: ${error.message}`);
    });
});

4. 混用回调和Promise导致的问题 #

如果你的异步操作是基于回调的（比如一些老的Node.js库），没有正确转换成Promise，也会导致运行时无法追踪状态。可以用Node.js内置的util.promisify把回调函数转换成Promise：

const util = require('util');
// 假设oldCallbackFunc是一个基于回调的函数
const promisifiedFunc = util.promisify(oldCallbackFunc);

exports.legacyOperation = functions.https.onRequest(async (req, res) => {
  try {
    const result = await promisifiedFunc();
    res.send(result);
  } catch (error) {
    res.status(500).send(`操作失败: ${error.message}`);
  }
});

你可以对照上面的情况检查一下你的代码，大概率是没有正确返回Promise给函数运行时导致的。

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