Flutter使用mailer2发送带Android本地存储图片HTML邮件的实现方法
问题根因
直接写入安卓设备内部存储的绝对路径无法生效,因为邮件经SMTP发送到远程邮箱服务器后,收件人在自身设备打开邮件时,根本无权访问发件人手机的本地存储路径。要让本地图片在邮件HTML中正常显示,只有两种合规方案:一是使用所有收件人都可公开访问的公网图片URL(你已验证该方式可行),二是按照邮件协议标准将图片作为内嵌CID(Content-ID)附件和HTML内容绑定,这是实现本地图片嵌入的唯一兼容方案。
实现步骤
1. 配置Android端存储读取权限
要读取DCIM目录下的图片,需要先在android/app/src/main/AndroidManifest.xml中添加对应权限,否则无法读取本地文件:
<!-- Android 12及以下版本 --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <!-- Android 13及以上版本,适配媒体文件读取规则 --> <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
同时需要在Flutter运行时动态申请上述权限,否则权限不会自动生效。
2. CID绑定逻辑
将本地图片作为内嵌附件添加到邮件结构中,为附件设置唯一的Content-ID标识,再在HTML的img标签中通过cid:标识值的格式引用,替代原来的本地绝对路径,邮箱客户端会自动匹配对应附件完成渲染。
3. 改造原有发信代码
保留你原有可正常发送文本邮件的逻辑,仅补充附件配置、调整HTML模板即可,完整适配后的代码如下:
import 'dart:io'; import 'package:mailer/mailer.dart'; // 原有其他import保持不变 sendMail() async { String mensaje=''; // 配置本地图片路径与唯一CID标识 const String imagePath = '/storage/emulated/0/DCIM/Camera/20210205_155258.jpg'; const String imageCid = 'embedded_camera_img'; var options = new GmailSmtpOptions() ..username = 'xxxxxxxxxxxxxxx@gmail.com' ..password = 'xxxxxxxxxxxxxxxxxxxxxx'; var emailTransport = new SmtpTransport(options); // 构造内嵌图片附件,标记为内嵌内容而非普通下载附件 final imgAttachment = FileAttachment( File(imagePath), disposition: ContentDisposition.INLINE, contentId: imageCid, ); // 自定义HTML模板,img标签直接通过cid引用图片,不要写入本地绝对路径 String htmlTemplate = ''' <div> <p>这是嵌入本地图片的测试邮件</p> <img src="cid:$imageCid" alt="MyImages" style="max-width: 100%;"> </div> '''; var envelope = new Envelope() ..from = 'xxxxxxxxx@gmail.com' ..recipients.add('xxxxxxxxxxxxx@gmail.com') ..bccRecipients.add('xxxxxxxxxxxxxx@gmail.com') ..subject = ' images' ..text = 'This is a email message.' ..html = htmlTemplate // 将图片附件加入邮件发送结构 ..attachments.add(imgAttachment); await emailTransport .send(envelope) .then((envelope) => mensaje = 'Email sent!') .catchError((e) => mensaje = 'Error occurred: $e'); return mensaje; }
关键注意事项
- Content-ID标识需要和HTML中
cid:后的内容完全一致,大小写敏感,匹配错误会导致图片无法加载 - 不要将图片设置为普通附件(
ContentDisposition.ATTACHMENT),否则图片会以下载项形式存在,不会直接嵌入HTML内容显示 - 不建议将图片转base64编码直接写入img的src属性,这种方式兼容性极差,大部分主流邮箱客户端会拦截大体积的base64内嵌内容,CID附件的方式是全客户端兼容性最好的实现
- 部分邮箱客户端出于安全策略,会默认屏蔽内嵌图片,需要收件人手动选择显示图片,这属于客户端侧的安全设置,不属于代码问题
内容的提问来源于stack exchange,提问作者Nautilus
相关产品推荐
相关产品推荐

