MS Bot Framework问题：含音频附件的消息丢失

你遇到的这个问题在Bot Framework开发里挺常见的——本地测试用base64内嵌附件一切正常，部署到线上就出现消息丢失，我来帮你拆解下可能的原因和对应的解决办法：

可能的问题根源 #

• 渠道兼容性限制：很多主流聊天渠道（比如Teams、Slack）并不支持data URI格式的内嵌base64作为附件地址，这类渠道更认可公开可访问的HTTPS URL，内嵌base64可能被渠道的安全策略直接拦截。
• 消息大小超限：base64编码会让文件体积增加约30%，如果原文件本身偏大，很容易超过渠道的单条消息大小限制，导致消息被后台直接丢弃。
• Node.js API兼容性：你代码里用的new Buffer()在Node.js较新版本中已经被废弃，换成Buffer.from()更安全，旧API可能在部署环境中引发隐性的编码错误。

具体解决方案 #

方案1：改用公开云存储URL（优先推荐） #

这是兼容性最好的方案，几乎所有聊天渠道都支持。把文件上传到云存储（比如Azure Blob Storage），拿到公开访问的HTTPS URL后直接作为contentUrl使用：

// 假设已完成文件上传，获取到了可公开访问的publicUrl
const msg = new builder.Message(session)
  .setText(text)
  .addAttachment({ 
    contentUrl: publicUrl, 
    contentType: contentType,
    name: '你的文件名.ext' // 建议加上文件名，提升用户接收附件时的体验
  });
session.send(msg);

方案2：优化base64内嵌方式（如果必须使用内嵌） #

如果业务场景要求必须用内嵌base64，试试这几个调整：

1. 替换废弃的Buffer API：

// 用Buffer.from替代旧的new Buffer，避免版本兼容性问题
const base64 = Buffer.from(filedata).toString('base64');
const msg = new builder.Message(session)
  .setText(text)
  .addAttachment({ 
    contentUrl: `data:${contentType};base64,${base64}`, 
    contentType: contentType,
    name: '你的文件名.ext'
  });
session.send(msg);

2. 严格控制文件大小：先测试几KB的小文件是否能正常发送，如果可以，说明是大文件超限问题，需要压缩文件或者拆分发送。
3. 确认contentType完全正确：比如docx对应的MIME类型是application/vnd.openxmlformats-officedocument.wordprocessingml.document，pdf是application/pdf，拼写错误会直接导致附件加载失败。

方案3：排查渠道特性 #

先确认你部署后使用的聊天渠道是否支持data URI格式的附件。比如部分企业内部渠道会屏蔽内嵌base64来防范安全风险，这种情况下只能改用云存储URL的方式。

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