uniCloud 本身不提供邮件发送能力,需调用阿里云DirectMail等支持HTTP API的第三方邮件服务,在云函数中用httpclient.request实现;须注意签名、编码、超时、密钥管理及发信资质配置。

uniCloud 本身不提供邮件发送能力,也没有内置的 sendEmail 或类似云函数接口。所谓“云端邮件通知”,实际是靠你调用第三方 SMTP 服务(如腾讯企业邮箱、阿里云邮件推送、SendGrid、Mailgun 等)来实现的,而 uniCloud 仅作为执行环境——你需要自己写云函数封装发信逻辑。
为什么不能直接用 uniCloud 发邮件?
-
uniCloud运行在受控的 Serverless 环境中,默认禁止外网 TCP 连接(尤其是 SMTP 的 25/465/587 端口),部分云厂商(如阿里云)甚至明确限制 SMTP 直连。 - 即使某些区域允许,也极容易被目标邮件服务器识别为垃圾源而拒收或进垃圾箱。
- 没有官方 SDK 或
uniCloud.getMailer()这类 API,一切需手动处理。
怎么在 uniCloud 里真正发邮件?
你需要一个支持 HTTP API 的邮件服务商,并在云函数中用 uniCloud.httpclient.request 调用其接口:
- ✅ 推荐:阿里云「邮件推送」(DirectMail)、腾讯云「SES」、SendGrid(国际常用)
- ❌ 避免:直接连 QQ/163 邮箱 SMTP(大概率失败,且易触发风控)
示例(阿里云 DirectMail):
// 云函数 sendMail.js
exports.main = async (event, context) => {
const { to, subject, text } = event;
const accessKeyId = 'your-access-key-id';
const accessKeySecret = 'your-access-key-secret';
// 构造签名、时间戳等(参考阿里云文档)
const params = {
Action: 'SingleSendMail',
AccountName: 'your-verified-email@domain.com',
AddressType: '1',
ToAddress: to,
Subject: subject,
HtmlBody: `<p>${text}</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/gongju/2488" title="uni-app"><img
src="https://img.php.cn/upload/manual/001/431/639/6a6029e0c4cd4231.png" alt="uni-app" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/gongju/2488" title="uni-app">uni-app</a>
<p>uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。</p>
</div>
<a href="/xiazai/gongju/2488" title="uni-app" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>`,
Version: '2017-06-22'
};
const res = await uniCloud.httpclient.request(
'https://dm.aliyuncs.com/',
{
method: 'GET',
data: params,
auth: { accessKeyId, accessKeySecret }
}
);
return res;
};注意:
- 阿里云要求所有参数参与签名,必须用
crypto模块生成 Signature(uniCloud支持 Node.js 内置 crypto) - 必须先在控制台完成域名验证、发信地址验证、设置白名单 IP(云函数出口 IP 是动态的,建议用「泛域名白名单」或联系客服加白)
容易踩的坑
-
uniCloud免费版单次云函数执行超时是 5 秒,发邮件若没设 timeout 容易卡住或失败 → 建议设timeout: 8000 - 邮件内容含中文时,
subject必须做 RFC 2047 编码(例如encodeURIComponent+UTF-8前缀),否则显示乱码 - 阿里云 DirectMail 对免费用户有每日额度(通常 200 封),超出后返回
MailFromBlocked错误 - 不要硬编码密钥 → 用
uniCloud.getSecretValue(需开通密钥管理服务)或环境变量(process.env.MAIL_SECRET)
替代方案:用 Webhook 中转(更稳)
如果你发现云函数直连邮件 API 不稳定,可以:
- 自建一个极简 Express 服务(部署在 VPS 或云函数外的轻量应用)
- 该服务只做一件事:接收 JSON 请求 → 转发给 SMTP / SendGrid
- 云函数只调它的 HTTPS 地址,绕过
uniCloud的网络限制和签名复杂度
这种方式调试快、容错强,适合中小项目上线初期。
真正能跑通的关键不在“怎么写”,而在“选对服务商 + 正确配置发信身份 + 处理好编码与超时”。别指望抄个代码就发成功,每家邮件平台的鉴权逻辑和字段名都不同,必须对照其最新 OpenAPI 文档逐项校验。

















