Alexa访问Firebase Firestore数据库时Intent请求超时问题排查与解决

问题成因 #

从你的描述和代码来看，虽然业务逻辑已经完成（日志能正确输出库存），但Alexa仍触发超时，核心原因有两个：

1. Firebase连接未释放导致事件循环阻塞
   Firebase的Node.js客户端会默认维持长连接池，即便你完成了查询操作，这些活跃连接也会留在Node.js的事件循环中。如果你的技能部署在AWS Lambda这类无服务器环境，Lambda会等待事件循环完全清空才会结束进程、返回响应给Alexa——这就导致明明业务逻辑已经完成，却因为后台连接未关闭，延迟了响应返回的时机，最终触发Alexa的8秒超时限制。

2. 全集合查询的性能损耗
   你当前的代码是拉取warehouses集合的所有文档到本地后再筛选，这种方式在集合数据量增大时，会显著增加查询和数据传输的时间。即使现在数据量小，也可能刚好卡在Alexa的超时阈值边缘，再加上连接未释放的问题，就触发了超时。

具体解决方案 #

1. 优化Firestore查询，避免全集合拉取

不要把整个集合的数据都拉到本地处理，直接通过查询条件获取目标仓库的文档，能大幅减少查询时间：

• 如果whNumber对应仓库文档的ID：

const getWarehouseStock = async (whNumber) => {
  console.log('WH Number---------------> ', whNumber);
  // 直接获取目标文档，无需拉取全集合
  const warehouseDoc = await firebase.firestore().collection('warehouses').doc(whNumber.toString()).get();
  
  let whStock = 0;
  if (warehouseDoc.exists && 'products' in warehouseDoc.data()) {
    console.log('WH INFO---------------> ', warehouseDoc.data());
    whStock = Object.keys(warehouseDoc.data().products).length;
  }
  console.log('WH Stock---------------> ', whStock);
  return whStock;
}

• 如果whNumber是文档中的某个字段（比如warehouseNumber）：

const getWarehouseStock = async (whNumber) => {
  console.log('WH Number---------------> ', whNumber);
  const snapshot = await firebase.firestore().collection('warehouses')
    .where('warehouseNumber', '==', parseInt(whNumber)) // 匹配目标字段
    .limit(1) // 只取第一个匹配结果
    .get();
  
  let whStock = 0;
  if (!snapshot.empty) {
    const warehouseData = snapshot.docs[0].data();
    console.log('WH INFO---------------> ', warehouseData);
    if ('products' in warehouseData) {
      whStock = Object.keys(warehouseData.products).length;
    }
  }
  console.log('WH Stock---------------> ', whStock);
  return whStock;
}

2. 主动释放Firebase连接，清空事件循环

在完成数据库操作后，主动关闭Firebase的应用实例，避免连接留在事件循环中。可以在getWarehouseStock函数返回前添加以下代码：

// 完成查询后关闭Firebase应用
await firebase.app().delete();

注意：如果你的技能需要处理会话内多次请求，不要每次都删除应用，而是考虑复用连接。但对于单次请求场景，用完即删能有效避免事件循环阻塞。

3. 检查部署环境的超时配置

如果使用AWS Lambda部署，确保Lambda的超时时间设置不小于8秒（比如设置为10秒），同时要保证业务逻辑（包括查询和处理）能在8秒内完成——毕竟Alexa的超时阈值是硬限制，必须保证响应在规定时间内返回。

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