Teams桌面/Web端Task Module加载空白 仅移动端正常

这个跨端表现不一致的问题核心原因是：Teams桌面端、Web端强制要求Task Module内加载的自定义页面必须引入Teams JS SDK并完成初始化，移动端无该校验规则所以可正常加载。

修复页面代码 #

你当前/api/messages/player接口返回的HTML只有裸iframe，缺少Teams强制要求的初始化逻辑，直接替换为以下代码即可：

[HttpGet("player")]
public IActionResult Player()
{
    var html = @"<!DOCTYPE html>
<html>
<head>
    <meta charset=""UTF-8"">
    <!-- 引入Teams官方JS SDK -->
    <script src=""https://res.cdn.office.net/teams-js/2.13.0/js/MicrosoftTeams.min.js""></script>
</head>
<body>
    <iframe width=""640"" height=""360"" src=""https://xxx.westeurope.azurecontainer.io/api/messages/test"" frameborder=""0"" allow=""autoplay; encrypted-media"" allowfullscreen=""allowfullscreen""></iframe>
    <script>
        // 页面加载后立即调用初始化，通知Teams完成跨域鉴权
        microsoftTeams.initialize();
    </script>
</body>
</html>";
    return new ContentResult
    {
        Content = html,
        ContentType = "text/html"
    };
}

你之前遇到的service worker超时、页面加载数秒后消失的问题，本质是Teams客户端在固定超时时间内没有收到页面initialize()的成功回调，直接卸载了iframe内容，和业务代码无关。

补充校验项 #

• 检查manifest.json的validDomains配置：除了自身服务域名，iframe加载的流地址域名、静态资源CDN域名都需要加入列表，不能遗漏
• 检查页面响应头：不能返回X-Frame-Options: DENY/SAMEORIGIN，如果配置了Content-Security-Policy，需要允许Teams官方域名嵌入页面
• 你测试的YouTube链接、其他第三方网站加载空白属于正常现象：这些第三方页面不会主动调用Teams SDK初始化，桌面端必然无法加载，和manifest配置无关

Deep link异常问题说明 #

• 调用其他应用APP_ID拼接的deep link无响应/卡死属于权限问题：只有你自己侧载/上架的应用对应的APP_ID，才有权限在当前租户环境唤起Task Module，使用其他应用ID会被客户端直接拦截
• 替换为自身APP_ID后仍空白，就是前面提到的缺少SDK初始化的问题，修复页面代码后即可正常加载

内容的提问来源于stack exchange，提问作者Brewcrew-MJ