基于Node.js botbuilder的Teams个人Bot无法捕获用户卸载事件求助

核心原因说明 #

你之前接入对话事件未触发，是因为个人范围的Bot卸载操作对应的不是通用conversationUpdate事件，而是installationUpdate事件；且大量用户不会主动到「应用管理」页卸载Bot，仅会直接删除和Bot的1:1个人聊天，这类操作本身就不会触发卸载类事件，仅靠事件监听无法覆盖所有无效会话场景。

可行落地方案 #

1. 正确适配installationUpdate事件覆盖显式卸载场景 #

• 首先替换你之前的事件监听逻辑，Node.js SDK下需要在processActivity中判断活动类型为installationUpdate，而非旧版的安装/卸载事件回调
• 确认manifest中已声明TeamsAppInstallation.ReadWriteSelfForUser.All权限，且对应应用注册的权限已完成用户/管理员同意，否则事件不会推送到你的后端
• 事件触发时根据action字段判断动作：add为安装时存储会话，remove为卸载时立即删除数据库中对应用户的会话记录
• 参考代码片段：

adapter.processActivity(req, res, async (context) => {
  // 监听安装/卸载事件
  if (context.activity.type === 'installationUpdate') {
    const userId = context.activity.from.id;
    if (context.activity.action === 'remove') {
      // 卸载动作触发，清除本地存储的会话引用
      await deleteStoredConversationRef(userId);
    } else if (context.activity.action === 'add') {
      // 安装动作触发，存储会话引用
      await saveConversationRef(userId, context.activity.conversation);
    }
  }
  // 原有Bot业务逻辑继续执行
  await botLogic.run(context);
});

2. 主动消息发送前置错误捕获兜底（最可靠方案） #

事件监听无法覆盖用户直接删除1:1聊天的场景，发送主动消息时的错误捕获是无遗漏的兜底方案：

• 调用continueConversation发送主动消息时，额外捕获会话失效类错误，常见错误码包括ConversationNotFound、BotNotAllowed、403状态码等，这类错误对应用户已卸载Bot、或已删除和Bot的聊天
• 捕获到这类错误时，立即从数据库中删除对应用户的会话存储记录，后续定时任务就不会再向该用户发起推送
• 参考错误处理代码：

async function sendProactiveMessage(conversationRef, msgContent) {
  try {
    await adapter.continueConversation(conversationRef, async (context) => {
      await context.sendActivity(msgContent);
    });
  } catch (err) {
    // 命中会话失效错误，清除无效存储
    if (err.statusCode === 403 || ['ConversationNotFound', 'BotNotInConversation'].includes(err.code)) {
      await deleteStoredConversationRef(conversationRef.user.aadObjectId);
    }
    // 非会话失效错误正常抛出
    throw err;
  }
}

3. 定期批量校验会话有效性（可选优化） #

• 对于存储了大量会话的场景，可每隔固定周期遍历所有已存储的会话引用，调用轻量校验接口（如获取会话成员列表），能正常返回结果的会话保留，调用失败的直接清除
• 该方案可在发送批量主动消息前提前过滤无效会话，避免无效请求消耗资源

注意事项 #

• 不要依赖单一的卸载事件监听，用户操作路径分散（卸载/删聊天/隐藏应用等），仅靠事件无法覆盖所有无效会话场景
• 个人范围Bot的事件触发需要对应权限已完成同意，若权限未配置或未同意，所有安装/卸载类事件都不会推送

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