Microsoft Teams连接器removeUrl页面点击移除按钮无法加载问题

排查与修复步骤 #

• 第一，确认配置保存逻辑完整
  调用setSettings后必须配套调用microsoftTeams.settings.save()方法才能将配置持久化到Teams服务端，仅调用setSettings不会保存你设置的removeUrl，正确的配置代码如下：

microsoftTeams.settings.setSettings({
    entityId: "MyConnector002",
    contentUrl: `https://msteams.whatever.com/connectorsetup.html`,
    removeUrl: `https://msteams.whatever.com/connectorremove.html`,
    configName: 'Active'
});
// 新增save调用持久化配置
microsoftTeams.settings.save((success) => {
    if(success) {
        microsoftTeams.settings.setValidityState(true);
    }
});

• 第二，检查应用清单的合法域名配置
  removeUrl对应的域名msteams.whatever.com必须添加到Teams应用清单的validDomains字段中，Teams会拦截所有不在合法域名列表内的页面加载请求，这也是为什么你直接在浏览器打开页面正常、但Teams内不加载的常见原因。
• 第三，确认移除页面正确初始化Teams SDK
  你的connectorremove.html必须先完成Teams SDK初始化，再注册移除事件处理函数，否则事件不会触发，页面参考写法如下：

// 页面加载后第一时间执行SDK初始化
microsoftTeams.initialize();
// 初始化完成后注册移除回调
microsoftTeams.settings.registerOnRemoveHandler(() => {
    // 此处添加你的自定义清理逻辑
    console.log("触发移除操作");
    // 逻辑处理完成后必须调用removeSuccess通知Teams完成移除流程
    microsoftTeams.settings.removeSuccess();
});

• 第四，排查网络访问问题
  可以在Teams网页版复现移除操作，同时打开浏览器开发者工具的网络面板，确认是否有发起到removeUrl的请求：
  • 如果没有发起请求，回到前两步检查配置保存和域名配置
  • 如果有请求但返回错误，检查你的页面是否有权限校验、跨域配置是否正确、是否有内网访问限制

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