Flutter 邮件发送:SMTP 流程与凭据边界

整理 enough_mail 的连接、认证、消息构建和发送流程,以及客户端凭据处理。

适用版本

原文使用 enough_mail 1.3.6,发布于 2021 年,API 以该历史版本为背景。

本文目录
  1. 明确邮件由谁发送
  2. 连接与认证
  3. 构建与发送消息
  4. 反馈界面与日志
  5. 参考

原文用 enough_mail 1.3.6 连接 QQ 邮箱 SMTP,完成邮件反馈。连接、认证、构建 MIME 消息和发送的顺序可以保留,但应用内嵌入一个共用邮箱授权码会使凭据随客户端分发。

明确邮件由谁发送

个人邮件客户端可以让用户配置自己的邮箱,并由用户授权发送。面向公众的意见反馈功能则适合把内容提交给自己的服务端,由服务端保管发件凭据、限制发送频率和记录结果。

本文的 SMTP 示例使用调用方传入的参数,仅表达协议流程。它不提供默认账户,也不把授权码写在源代码中。

连接与认证

dart
final client = SmtpClient('feedback-client', isLogEnabled: false);
await client.connectToServer(smtpHost, smtpPort, isSecure: true);
await client.ehlo();

if (client.serverInfo.supportsAuth(AuthMechanism.plain)) {
  await client.authenticate(userName, authorizationCode, AuthMechanism.plain);
} else if (client.serverInfo.supportsAuth(AuthMechanism.login)) {
  await client.authenticate(userName, authorizationCode, AuthMechanism.login);
} else {
  throw StateError('服务器没有提供此示例支持的认证方式');
}

主机、端口和 TLS 方式来自邮箱服务商的配置,授权码不等同于网站登录密码。上面的 isSecure: true 表达直接建立 TLS 连接的场景;需要 STARTTLS 的服务要采用对应流程。

构建与发送消息

dart
import 'dart:convert';

final builder = MessageBuilder.prepareMultipartAlternativeMessage(
  plainText: feedbackText,
  htmlText: '<p>${const HtmlEscape().convert(feedbackText)}</p>',
)
  ..from = [MailAddress(senderName, senderEmail)]
  ..to = [MailAddress(recipientName, recipientEmail)]
  ..subject = '应用反馈';

final response = await client.sendMessage(builder.buildMimeMessage());
if (!response.isOkStatus) {
  throw StateError('SMTP 服务器未接受此次发送');
}

这些变量由业务代码提供。HTML 版本对用户文本转义,避免把反馈内容直接当作标签解析。生产实现还要处理超时、异常和连接关闭;发送后不能把服务器接受邮件等同于最终送达收件箱。

反馈界面与日志

发送期间禁用重复操作,失败后保留用户输入。错误信息说明连接或发送失败即可,不把授权码、认证报文或完整私人邮件打印到日志。用户反馈中的附件与设备信息,也应在界面中说明并由用户选择。

旧文提到邮箱后台的 POP3/SMTP 开关,它只表达当时账户开通服务的入口。账户授权方式和后台菜单可能变化,实际配置以邮箱服务商当前说明为准。

参考

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。