嘿，我刚好碰到过一模一样的问题！Teams客户端里的iframe安全限制比网页版严格不少，直接跳转到文件链接会触发iframe导航拦截，导致页面空白。给你几个靠谱的解决方案，按优先级来：

1. 用Teams JavaScript SDK处理下载（最推荐） #

Teams客户端不允许iframe直接跳转到外部下载链接，但可以通过官方SDK让Teams本身接管这个请求，避免iframe被重置。步骤如下：

首先确保你的SPFx项目已经安装了Teams SDK：

npm install @microsoft/teams-js

然后在你的web part代码里初始化SDK，并在下载点击事件里调用executeDeepLink方法：

import * as microsoftTeams from "@microsoft/teams-js";

// 在web part初始化时加载Teams SDK
public onInit(): Promise<void> {
  return new Promise<void>((resolve) => {
    microsoftTeams.initialize();
    resolve();
  });
}

// 处理下载按钮的点击事件
private handleFileDownload(fileUrl: string): void {
  try {
    // 让Teams客户端直接处理下载链接，不会影响iframe
    microsoftTeams.executeDeepLink(fileUrl);
  } catch (error) {
    // 如果是网页版Teams（或者SDK调用失败）， fallback到常规新窗口打开
    window.open(fileUrl, "_blank");
  }
}

这样处理后，Teams客户端会弹出下载提示，而iframe不会被重定向空白，网页版也能正常工作。

2. 检查并配置SPFx的内容安全策略（CSP） #

Teams客户端的CSP规则比网页版更严格，如果你的文件域名不在允许列表里，可能会被拦截。你需要在SPFx的配置文件里添加对应的域名：

打开config/package-solution.json，在solution节点下添加contentSecurityPolicy（如果没有的话）：

{
  "solution": {
    "contentSecurityPolicy": "default-src 'self' https://your-file-domain.com; style-src 'self' 'unsafe-inline'; script-src 'self' 'unsafe-inline' 'unsafe-eval'"
  }
}

把https://your-file-domain.com替换成你实际的文件存储域名（比如SharePoint站点域名）。

3. 前端生成Blob下载链接（备选方案） #

如果你的文件存储在SharePoint里，可以通过SPFx的REST API先获取文件的Blob，然后在前端生成本地下载链接，完全避免外部跳转：

import { sp } from "@pnp/sp/presets/all";

// 从SharePoint下载文件的方法
private async downloadSPFile(fileRelativePath: string, fileName: string): Promise<void> {
  // 获取文件Blob
  const blob = await sp.web.getFileByServerRelativePath(fileRelativePath).getBlob();
  // 创建临时下载链接
  const downloadUrl = window.URL.createObjectURL(blob);
  // 创建隐藏的a标签触发下载
  const linkElement = document.createElement("a");
  linkElement.href = downloadUrl;
  linkElement.download = fileName;
  document.body.appendChild(linkElement);
  linkElement.click();
  // 清理临时资源
  window.URL.revokeObjectURL(downloadUrl);
  document.body.removeChild(linkElement);
}

这种方式完全在前端处理，不会触发任何iframe导航，在Teams客户端和网页版都能稳定工作。

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