Teams客户端点击新消息通知时已打开Task Module无法关闭

• 已在Teams个人tab中唤起Task Module弹窗的状态下，点击右下角弹出的新聊天消息通知，对应聊天详情会在后台加载，但前台的Task Module弹窗不会自动关闭
• 此时Task Module自带的关闭按钮完全无响应，无法通过常规操作关闭弹窗，只能重启Teams客户端恢复交互

Node.js环境下Teams tab中唤起Task Module的原始实现代码：

let url = window.location.origin + "/GetData?" + id ;
let taskInfo = {
  url: url,
  title: "Get Info",
  height: 300,
  width: 600,
  fallbackUrl: url
}
microsoftTeams.tasks.startTask(taskInfo, (err, result) => {
  console.log(`Submit handler - err: ${err}`);
  microsoftTeams.tasks.submitTask();
});

• 客户端机制缺陷：Teams的Task Module基于全局模态层实现，从tab场景点击通知跳转至聊天场景时，客户端未正确处理全局模态层的上下文归属：既没有将Task Module随原tab一起隐藏，也没有将弹窗的事件监听绑定到全局上下文，导致关闭按钮的点击事件因原tab被后台挂起无法触发，透明遮罩层拦截所有点击操作，直接锁死交互。
• 代码逻辑隐患：startTask回调中无条件执行microsoftTeams.tasks.submitTask()，没有区分用户主动提交、手动关闭、异常触发回调三类场景。上下文切换时SDK会异常触发startTask回调，此时无差别调用submitTask()会和客户端原生的弹窗生命周期逻辑冲突，进一步锁死弹窗状态，导致强制关闭逻辑无法生效。
• 初始化缺失：如果Task Module加载的目标页面（即/GetData路由对应页面）没有调用SDK初始化方法，会导致弹窗和客户端的通信通道断开，所有关闭、提交操作都会失效。

• 修正startTask回调逻辑，禁止无条件调用submitTask()，根据回调返回的错误、结果参数区分场景处理，参考实现：

microsoftTeams.tasks.startTask(taskInfo, (err, result) => {
  // 捕获用户取消、异常关闭场景，直接退出不调用submitTask
  if (err) {
    console.log("Task module closed abnormally, error:", err);
    return;
  }
  // 仅在接收到有效提交结果时，才调用submitTask向tab传递结果
  if (result) {
    microsoftTeams.tasks.submitTask(result);
  }
});

• 增加页面可见性监听，在tab切到后台（即触发聊天跳转）时主动关闭已打开的Task Module，避免状态锁死：

document.addEventListener("visibilitychange", () => {
  if (document.hidden) {
    try {
      // 传空值标识为上下文切换触发的关闭，不传递业务结果
      microsoftTeams.tasks.submitTask(null, "contextSwitch");
    } catch (e) {
      // 无已打开的Task Module时调用会抛错，直接忽略即可
    }
  }
});

• 检查Task Module加载的/GetData对应页面，在页面加载入口第一时间调用microsoftTeams.initialize()完成SDK初始化，建立和Teams客户端的通信通道。
• 若当前使用的@microsoft/teams-js SDK版本低于1.12，先升级至1.12及以上稳定版本，旧版本存在上下文切换后Task Module事件绑定丢失的已知问题。

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