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
相关产品推荐
相关产品推荐

