云函数中nodemailer发信失败返回EENVELOPE错误如何解决

EENVELOPE 是nodemailer抛出的邮件信封参数校验失败错误，代表发件人/收件人地址存在非法值，结合你提供的代码，有几个直接触发问题的点：

• 错误处理逻辑存在漏洞：sendMail 触发error分支时，你仅调用了res.send(error.message)，没有终止函数执行，后续代码会尝试读取值为undefined的info对象，导致你拿到的错误返回残缺，看不到具体的失败原因。
• 收件人参数大概率无效：req.body.userEmail 为空、格式不符合邮箱规范、字段名不匹配是触发这个错误的最常见原因。比如axios发请求时没正确传参、字段拼写错误、传了空值/非邮箱字符串，都会让nodemailer在校验收件人环节直接失败。
• 代码里的HTML模板存在语法错误：'<h1>Test message/h1>' 闭合标签缺失斜杠，虽然不会直接触发EENVELOPE错误，但会导致邮件内容渲染异常。
• 额外注意：from 字段的发件地址必须和SMTP认证使用的邮箱地址完全一致，如果你后续修改了发件人别名，需要提前在Gmail后台完成配置，否则也会触发信封校验错误。

• 首先修复错误处理逻辑，在错误响应分支加return终止函数执行，拿到完整的错误信息方便定位：

transporter.sendMail(mailOptions, (error, info) => {
    if (error) {
        return res.status(500).send({
            errorCode: error.code,
            errorMsg: error.message,
            command: error.command
        })
    }
    const sendMailResponse = {
        accepted: info.accepted,
        rejected: info.rejected,
        pending: info.pending,
        envelope: info.envelope,
        messageId: info.messageId,
        response: info.response,
    }
    res.send(sendMailResponse)
})

• 校验接口入参：在云函数逻辑开头打印完整的req.body内容，确认req.body.userEmail、req.body.doctorName均存在有效值，其中userEmail必须是符合邮箱格式的字符串，不能是undefined、null、空字符串。如果使用axios发请求，确认已设置Content-Type: application/json请求头，body内的字段名和代码中读取的字段名完全一致，无拼写错误。
• 修复HTML模板语法错误，将错误的h1标签修正为<h1>Test message</h1>。
• 验证Gmail SMTP配置有效性：确认配置中填写的pass是Gmail账号开启两步验证后生成的专用应用密码，而非账号普通登录密码，且账号未被限制SMTP发信权限。可以先写死固定的有效收件人邮箱做本地测试，确认基础发信逻辑跑通后，再对接动态入参。
• 低概率排查项：如果云函数部署在国内云平台，可检查出网规则是否拦截465端口的境外连接，但当前你拿到的是应用层参数校验错误，网络拦截的概率极低。

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