Teams Bot运行一段时间后无法发消息：findAllChannels丢失预期频道

问题背景 #

我们的Teams Bot存在周期性复现问题：触发通知事件时，Bot需向客户指定的Teams频道发送告警消息，已存储每位客户的Channel ID和Team ID，核心代码如下：

server.post(
  "/api/notification",
  restify.plugins.queryParser(),
  restify.plugins.bodyParser(), // Add more parsers if needed
  async (req, res) => {
    const body = req.body;
    if(body.type !== 'message') {
      res.json({status:'fail',err: 'is not message'})
      return ;}
    
      const channel = await notificationApp.notification.findChannel(c=> Promise.resolve(c.info.id === body.channelId))
      const allChannel = await notificationApp.notification.findAllChannels(c=> Promise.resolve(true))
    const result = await channel?.sendAdaptiveCard(AdaptiveCards.declare<CardData>(notificationTemplate).render({
      title: body.title,
      appName: "#####",
      description: body.description,
      notificationUrl: body.notificationUrl,
    }));
    res.json(channel ? {status: 'success' , data: allChannel} : {status: 'fail' , data: allChannel, channelId: body.channelId});
  }
);

Bot可正常运行一段时间，但会突然定期出现消息无法送达的情况。排查发现findAllChannels获取的频道列表大幅缩减，导致无法找到目标Channel ID，进而引发消息发送失败。客户移除并重新安装Teams中的App后，通知可恢复正常，但该方案需用户定期重装，并非可行解。

1. 根本原因 #

• 频道列表缓存过期未刷新：Teams Bot通知SDK（如TeamsFx）默认会缓存已订阅的频道信息，当Bot的身份令牌过期、微软侧的通知订阅会话超时，或客户调整了Bot的频道权限时，缓存的频道列表不会自动更新，导致findAllChannels返回过期、不完整的列表。
• 筛选逻辑异步误用：findChannel方法通常期望同步判断条件，代码中c=> Promise.resolve(c.info.id === body.channelId)的写法会导致筛选逻辑失效，可能误判目标频道不存在（叠加缓存问题时更明显）。
• 通知订阅未自动续订：Teams Bot的频道通知订阅存在有效期，若未配置自动续订机制，订阅过期后SDK无法获取最新的频道关联关系。

2. 实现方案调整 #

• 修正频道筛选逻辑：将findChannel的回调改为同步判断，避免Promise包装：

  const channel = await notificationApp.notification.findChannel(c => c.info.id === body.channelId);
  

• 主动刷新频道列表：在发送通知前强制刷新频道缓存，或设置定时刷新任务：

  // 发送前先刷新
  await notificationApp.notification.refreshChannels();
  const channel = await notificationApp.notification.findChannel(c => c.info.id === body.channelId);
  

• 增加容错与重试机制：当找不到目标频道时，先尝试刷新缓存并重试查找；若仍失败，触发权限校验流程（引导客户重新授权Bot访问对应频道，而非直接重装App）。
• 关联Team ID优化查询：结合存储的Team ID，当Channel ID查找失败时，通过Team ID重新拉取对应团队的全量频道列表再匹配：

  let channel = await notificationApp.notification.findChannel(c => c.info.id === body.channelId);
  if (!channel && body.teamId) {
    // 通过Team ID获取该团队下的频道
    const teamChannels = await notificationApp.notification.findChannels(c => c.info.teamId === body.teamId);
    channel = teamChannels.find(c => c.info.id === body.channelId);
  }
  

• 监听频道变更事件：通过Bot的webhook监听Teams团队/频道的权限变更、新增/删除事件，实时更新本地缓存的频道列表。

3. 是否与微软侧相关 #

周期性复现且重装App可恢复的情况，主要原因并非微软侧故障，但不排除极端场景：

• 微软侧临时出现Teams通知服务故障、API返回数据不完整，但这类问题通常是偶发且会快速修复，不会呈现周期性规律。
• 若排查自身缓存、订阅逻辑后问题仍存在，可通过微软365管理中心查看Teams服务状态，确认是否有对应时段的服务异常记录。

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