Bot Framework Teams频道图片轮播显示空白如何解决

• 直接将本地磁盘路径传入CardImage构造函数是核心诱因：单张HeroCard单独发送时，Bot Builder SDK 会自动读取本地图片文件、转换为内嵌base64数据格式传输给客户端，因此可以正常渲染；但轮播（Carousel）布局走批量附件序列化逻辑，不会触发单卡场景的自动本地文件转码逻辑，客户端拿到的是服务端的本地磁盘路径，无法跨环境访问到对应文件，最终渲染为空白轮播。
• 代码存在兼容性隐患：你先初始化空附件列表传入MessageFactory.Attachment，再向reply.Attachments追加卡片，部分SDK版本中该方法传入空集合时会生成长度固定的只读附件数组，后续调用Add方法会抛出集合修改异常，只是当前运行环境未触发该报错。
• 存在笔误：heroCard2引用的图片和heroCard1完全相同，均为Step1.png，修复问题后也会出现两张轮播内容一致的问题。

1. 不要直接给CardImage传本地物理路径：开发测试阶段可以手动读取本地图片转成base64数据URI传入，生产环境建议将图片上传到公网可访问的HTTPS静态资源/CDN地址，直接传入HTTPS图片地址即可（该方式兼容性最好，不会增大消息体体积）。
2. 调整附件初始化逻辑，先将所有卡片转换为Attachment加入列表，再传入消息工厂方法，避免集合只读问题。
3. 修正第二张卡片的图片路径，替换为实际对应的图片文件名。

修正后的可运行代码如下：

/// <summary>
/// 读取本地图片生成可被客户端识别的CardImage
/// </summary>
/// <param name="fileName">Resources目录下的图片文件名</param>
/// <param name="mimeType">图片MIME类型，png对应image/png，jpg对应image/jpeg</param>
private static CardImage BuildLocalCardImage(string fileName, string mimeType = "image/png")
{
    var fullPath = Path.Combine(Environment.CurrentDirectory, "Resources", fileName);
    var fileBytes = File.ReadAllBytes(fullPath);
    var dataUri = $"data:{mimeType};base64,{Convert.ToBase64String(fileBytes)}";
    return new CardImage(dataUri);
}

// 轮播卡片构建与发送逻辑
var card1 = new HeroCard
{
    Images = new List<CardImage> { BuildLocalCardImage("Step1.png") }
};
var card2 = new HeroCard
{
    // 替换为第二张图实际对应的文件名
    Images = new List<CardImage> { BuildLocalCardImage("Step2.png") }
};

// 先组装完整附件列表，再初始化消息
var carouselAttachments = new List<Attachment>
{
    card1.ToAttachment(),
    card2.ToAttachment()
};
var reply = MessageFactory.Attachment(carouselAttachments);
reply.AttachmentLayout = AttachmentLayoutTypes.Carousel;
await stepContext.Context.SendActivityAsync(reply);

注意：如果使用base64内嵌图片的方式，单张图片体积建议控制在1MB以内，否则可能超出渠道消息体大小限制，导致消息发送失败。

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