You need to enable JavaScript to run this app. Xamarin.Forms应用Syncfusion生成PDF作邮件附件后无法打开问题排查
优惠活动
大模型
产品
解决方案
定价
更多

Xamarin.Forms应用Syncfusion生成PDF作邮件附件后无法打开问题排查

PDF附件无法打开的排查路径

第一类:代码存在的硬伤(优先排查)

  • MemoryStream游标位置偏移问题(最高概率诱因)
    执行完doc.Save(stream)后,MemoryStream的读写游标会自动停在写入完成的末端位置。此时直接把该流传递给Attachment对象,附件组件会从当前游标位置开始读取内容——流开头的PDF文件标识、文档元数据部分会完全被跳过,最终收到的附件是从文档中部截断的无效字节流,即便文件大小有27KB,也因为缺少文件头无法被Adobe Reader识别打开。
    修复方式:在创建附件前,强制把流的游标重置到起始位置,添加代码stream.Position = 0;。
  • 数据赋值逻辑错误
    代码中创建了装载数据的List<object> data1,但后续给网格绑定数据源时写的是IEnumerable<object> dataTable = data;——此处引用的data变量并未在当前逻辑中定义,如果实际运行中绑定的是空数据源,会直接生成结构残缺的PDF文档。正确的赋值应为IEnumerable<object> dataTable = data1;。
  • 流生命周期不匹配问题
    当前代码中,MemoryStream是方法内的临时变量,在SmtpClient异步执行发信操作时,流可能已经被垃圾回收机制回收释放,导致附件读取到的内容是内存中残留的无效数据。建议在Save完成后直接把流内容转为字节数组,完全规避流的位置、生命周期问题:
    // 优化后的流处理逻辑
    MemoryStream stream = new MemoryStream();
    doc.Save(stream);
    // 提前提取PDF字节内容,再释放文档资源
    var pdfBytes = stream.ToArray();
    doc.Close(true);
    stream.Dispose();
    // 组装附件时用独立的内存流承载字节内容
    message.Attachments.Add(new Attachment(new MemoryStream(pdfBytes), "Test.pdf", "application/pdf"));
    
  • 邮件配置的格式错误
    new MailAddress("admin.server.com")不是合法的邮箱格式,正确格式应为admin@server.com,该问题一般会导致SMTP发信直接报错,若你能正常收到邮件说明本地代码已经修正,但仍需确认配置合法性,避免因发信链路异常导致附件被服务器篡改。

第二类:分步验证定位方法

  • 先跳过发信环节,在生成逻辑末尾把MemoryStream的内容直接保存到Xamarin应用的本地存储路径,直接打开本地保存的PDF文件做排查:
    • 如果本地保存的PDF本身就无法打开:需要核对Syncfusion PDF生成的执行顺序——必须严格按照「新建文档→添加页面→绘制内容→保存到流→关闭文档」的顺序执行,避免在未完成Save操作时提前关闭文档释放资源。
    • 如果本地保存的PDF可以正常打开:问题100%出在邮件附件组装环节,除了前面提到的流位置、生命周期问题,还要检查SMTP发信过程中有没有对附件二进制内容做Base64转码后的解码偏移,部分老旧邮件服务器会对非正确MIME标识的附件做内容截断。
  • 校验邮箱接收到的附件大小:如果邮箱端显示的附件大小和你本地生成的PDF文件大小不一致,说明传输过程中出现了内容截断,需要检查SMTP服务器的附件大小限制配置。

内容的提问来源于stack exchange,提问作者Rajzer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 22:06:02