Microsoft Bot Builder：添加PDF附件并实现在浏览器打开/下载

看起来你遇到的问题是Bot发送的PDF附件无法被正常打开/下载，大概率是附件的构造方式有问题。我来帮你分析并给出解决方案：

可能的问题根源 #

你的代码里尝试将本地PDF文件转成base64，但可能存在以下问题：

• 没有正确构造data URI格式的ContentUrl（缺少data:application/pdf;base64,前缀）
• ContentType设置错误（比如误设为图片类型，而非application/pdf）
• 直接使用本地文件路径而非可访问的URL（Bot Framework需要附件地址能被客户端浏览器访问）

推荐解决方案 #

根据文件大小，推荐两种实现方式：

方案1：使用公开可访问的URL（推荐大文件） #

把PDF放在网站的静态文件目录（比如~/Files/），直接用文件的绝对URL作为附件地址，这种方式更高效，适合大文件：

private static Attachment GetPdfAttachment()
{
    // 生成文件的绝对访问URL，确保外部能访问到这个地址
    var requestUrl = System.Web.HttpContext.Current.Request.Url;
    var fileUrl = $"{requestUrl.Scheme}://{requestUrl.Authority}/Files/mutuelle.pdf";

    return new Attachment
    {
        Name = "mutuelle.pdf", // 显示给用户的文件名
        ContentType = "application/pdf", // 必须设置为PDF的MIME类型
        ContentUrl = fileUrl // 文件的可访问URL
    };
}

方案2：使用Base64嵌入（适合小文件） #

如果必须嵌入文件内容，要正确构造data URI：

private static Attachment GetInlinePdfAttachment()
{
    var filePath = System.Web.HttpContext.Current.Server.MapPath("~/Files/mutuelle.pdf");
    var fileBytes = File.ReadAllBytes(filePath);
    var base64Content = Convert.ToBase64String(fileBytes);
    
    // 构造完整的data URI，这一步是关键！
    var dataUri = $"data:application/pdf;base64,{base64Content}";

    return new Attachment
    {
        Name = "mutuelle.pdf",
        ContentType = "application/pdf",
        ContentUrl = dataUri
    };
}

额外注意事项 #

• 确保~/Files/目录在IIS中被设置为允许静态文件访问，否则URL会返回404
• 发送附件时，要将Attachment添加到回复消息的Attachments集合中：

  var reply = activity.CreateReply("这是你需要的PDF文件：");
  reply.Attachments.Add(GetPdfAttachment());
  await connector.Conversations.ReplyToActivityAsync(reply);
  

• 如果使用Bot Framework v4，API会略有不同，但核心逻辑一致（设置正确的ContentType和ContentUrl）

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