适用版本
原文使用 enough_mail 1.3.6,发布于 2021 年,API 以该历史版本为背景。
原文用 enough_mail 1.3.6 连接 QQ 邮箱 SMTP,完成邮件反馈。连接、认证、构建 MIME 消息和发送的顺序可以保留,但应用内嵌入一个共用邮箱授权码会使凭据随客户端分发。
明确邮件由谁发送
个人邮件客户端可以让用户配置自己的邮箱,并由用户授权发送。面向公众的意见反馈功能则适合把内容提交给自己的服务端,由服务端保管发件凭据、限制发送频率和记录结果。
本文的 SMTP 示例使用调用方传入的参数,仅表达协议流程。它不提供默认账户,也不把授权码写在源代码中。
连接与认证
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 的服务要采用对应流程。
构建与发送消息
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 开关,它只表达当时账户开通服务的入口。账户授权方式和后台菜单可能变化,实际配置以邮箱服务商当前说明为准。


