Teams机器人内嵌图片无法下载问题排查及解决方案咨询

阿华AIGC实验室

2026-4-21

我完全理解你现在遇到的这个问题有多闹心——之前好好的Teams机器人内嵌图片下载功能突然失效，旧客户端连下载按钮都没了，新客户端点了下载按钮发了请求却没文件到本地，而且图片明明能正常显示、放大，就是下载环节掉链子，换谁都得头疼。

先帮你梳理下目前的核心情况：

之前机器人发送的内嵌图片支持正常下载，近期行为变更
旧Teams客户端：图片显示正常，但下载按钮消失
新Teams客户端：下载按钮存在，点击后发起请求，但无文件下载
使用旧版Bot SDK（基于ConnectorClient），发送的附件结构如下：

return new List<Attachment>()
{
    new Attachment
    {
        Content = "test.png",
        ContentType = "image/png",
        ContentUrl = "https://some.link.to.png"
    }
};

你也提供了直接调用Teams API的最小请求示例，结构和SDK生成的一致

可能的原因分析

从Teams平台的更新规律来看，大概率是平台对Bot发送图片附件的处理规则做了调整：

Attachment字段要求变更：旧版SDK里用Content字段存文件名的方式，可能不再被新版Teams客户端识别为可下载的文件标识——现在Teams可能更依赖name字段来标记附件的文件名，从而触发下载功能。
平台渲染逻辑更新：微软可能优化了内嵌图片的展示逻辑，区分了“纯展示图片”和“可下载图片”的判定条件，Bot发送的图片如果不符合新的规则，就会被当成纯展示内容，隐藏或禁用下载按钮。
资源响应头限制：虽然图片能正常显示，但你的图片服务器可能没有配置正确的响应头（比如Content-Disposition），导致Teams客户端无法触发下载动作；或者存在CORS规则限制了下载请求。

可行的解决方案建议

调整Attachment的字段结构
试试把Content字段替换为name字段，或者补充name字段，这是新版Teams推荐的附件命名方式：

return new List<Attachment>()
{
    new Attachment
    {
        Name = "test.png", // 替换或补充这个字段
        ContentType = "image/png",
        ContentUrl = "https://some.link.to.png"
    }
};

对应的API请求体也要调整：

{
  "type": "message",
  "from": { "id": "<bot id>" },
  "conversation": { "id": "19:<...>@thread.tacv2;messageid=<...>" },
  "locale": "en-Us",
  "attachments": [
    {
      "contentType": "image/png",
      "contentUrl": "https://www.starpng.com/public/uploads/preview/transparent-png-clipart-free-download-4-115822320505rpdpl1gbm.png",
      "name": "test.png" // 新增或替换为name字段
    }
  ],
  "entities": []
}

检查图片资源的响应配置
确认你的图片服务器返回的响应中包含Content-Disposition头，示例：
```
Content-Disposition: inline; filename="test.png"
```
这个头可以告诉Teams客户端，该资源既可以内嵌展示，也允许下载。同时确保服务器没有设置阻止跨域下载的CORS规则。
尝试以文件附件形式发送
如果内嵌图片的方式始终不行，可以尝试把图片作为文件附件发送，调整附件的类型标识（部分场景下Teams对文件附件的下载支持更稳定）。
适配平台最新规则（可选）
虽然你提到不想引入TurnContext等逻辑，但可以看看旧版SDK是否有兼容Teams新规则的补丁，或者尝试用更轻量化的方式调用Teams API，对齐普通用户发送图片时的请求结构（可以通过F12抓包对比同事发送图片的API请求）。