Nodemailer 邮件发送库
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/nodemailer-nodejs-email-sending-library 技能,用于在 Node.js 服务中发送邮件。
技能介绍
解决什么问题
在 Node.js 服务里发邮件看起来简单,真正做起来坑很多:SMTP 参数拼接、HTML 与纯文本双份正文、附件与内嵌图片的 MIME 处理、OAuth2 授权、以及把邮件交给 SES、SendGrid 这类托管服务而不是直连 SMTP。把这些问题分散在自己的代码里重写一遍,既容易出错,也难维护。
Nodemailer 把发邮件这件事收敛成一个库调用,让你把精力放在收件人、正文和模板上,而不是 MIME 组装和传输细节。
核心能力
- 基于 SMTP 直连发送,支持
host、servername、端口等连接参数的显式指定,避免默认值猜错。 - 支持 OAuth2 授权登录,适配需要第三方授权的邮箱账号。
- 同时处理 HTML 正文与纯文本,避免只发富文本时在客户端出现空白。
- 附件与内嵌图片由库负责编码,不用手拼 MIME 边界。
- 通过 自定义传输方式接入 SES、SendGrid 等服务,后续换服务商不必重写业务代码。
使用时要注意
- Node.js 版本至少为
v6.0.0;低于该版本无法使用展开运算符等语法,先升级再接入。 - 本机运行时检查杀软设置:安全软件常拦截邮件端口,Node.js 可能识别不了其注入的 MITM 证书。
- Gmail 兼容性不稳定:要么工作正常,要么完全不通。排错成本高时,建议直接换其他邮箱服务,不要在 Gmail 上反复试错。
更多细节以官方文档为准:https://nodemailer.com/
使用场景
- 后端工程师需要给注册用户发送包含HTML排版和纯文本备用正文的欢迎邮件。
- 运维人员要在系统告警触发时,自动生成日志快照文件作为附件,连同监控截图发送给值班群。
- 出海团队的后端服务需要将海量交易流水邮件通过AWS SES或SendGrid等托管通道批量投递。
- 企业内部系统需要调用OAuth2授权获取企业邮箱凭证,自动将审批结果PDF发送给申请人。
适合人员
- 后端开发工程师,正在为SaaS平台搭建用户注册、密码找回等核心业务链路的邮件通知模块。
- 运维与SRE工程师,需要将服务器宕机告警、性能异常日志等自动化监控数据通过邮件附件推送给值班人员。
- 出海业务技术负责人,正在寻找通过AWS SES或SendGrid等第三方托管服务发送大批量交易邮件的Node.js方案。