使用Flutter的flutter_email_sender包通过Gmail发送附件时出现「无法附加文件」错误

核心原因分析 #

1. 文件过早被删除：FlutterEmailSender.send()仅负责启动邮件应用的Intent，并非等待邮件发送完成。你在调用send后立即删除临时文件，导致Gmail实际读取附件时文件已不存在。编辑正文的操作会延迟Gmail读取附件的时机，此时文件可能还未被删除，因此能成功发送。
2. Android分区存储权限限制：Android 10+的分区存储机制下，Gmail可能无法直接访问你的App私有临时目录中的文件，而Outlook对文件路径的兼容性更好。
3. Gmail对空内容Intent的处理异常：即使设置了正文，若内容为空或格式不符合Gmail的预期，也可能导致附件加载失败。

具体解决方案 #

1. 延迟删除临时文件 #

不要在send后立即删除文件，改为延迟删除或依赖系统自动清理临时文件：

// send email
await FlutterEmailSender.send(email);

// 延迟10分钟删除文件，给Gmail足够的读取时间
Timer(Duration(minutes: 10), () async {
  if (await csvFile.exists()) {
    await csvFile.delete();
  }
});

2. 将文件保存到公共可访问目录 #

将CSV文件保存到外部存储的公共目录（如Downloads），确保Gmail有权限访问：

// 获取公共Downloads目录路径
String directoryPath = (await getExternalStorageDirectory())?.path ?? (await getTemporaryDirectory()).path;
String fileName = generateFileName();
File csvFile = await File('$directoryPath/$fileName').writeAsString(csv);

final Email email = Email(
  subject: 'subject',
  body: ' ', // 设置非空正文
  attachmentPaths: [csvFile.absolute.path],
);

await FlutterEmailSender.send(email);

// 同样延迟删除或手动管理文件

3. 确保正文非空 #

显式设置非空的正文内容，避免Gmail因空内容跳过附件处理：

final Email email = Email(
  subject: 'subject',
  body: '邮件正文内容', // 即使是简单的占位文本也可以
  attachmentPaths: [csvFile.absolute.path],
);

4. 升级flutter_email_sender包到最新版本 #

检查并升级flutter_email_sender到最新版，新版本可能修复了Gmail的兼容性问题：

flutter pub upgrade flutter_email_sender

额外验证步骤 #

• 确认临时文件生成成功：发送前打印csvFile.absolute.path，手动检查文件是否存在且内容正确。
• 测试不同Android版本：在Android 9及以下、Android 10+分别测试，验证是否是分区存储导致的问题。

内容的提问来源于stack exchange，提问作者Florent Rousselle