You need to enable JavaScript to run this app. Flutter使用mailer2发送带Android本地存储图片HTML邮件的实现方法
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.04 02:45:04