Node.js+Nodemailer@4.6.4+email-templates@3.6.0生产环境发件报错求助

我之前也踩过这个坑！开发环境跑的顺顺当当，一部署到生产服务器就报「No recipients defined」，折腾了好一阵才摸清楚几个常见的原因，给你分享下排查和解决思路：

1. 模板路径解析出错 #

开发环境本地的相对路径能正常找到模板文件，但生产环境可能因为代码打包（比如TS编译、webpack构建）后，模板文件夹的位置发生了变化，导致email-templates找不到模板，进而渲染失败，连带着收件人配置也没生成。

解决办法：

• 确保模板文件夹被正确打包到生产环境的输出目录，比如在package.json的构建脚本里加一步复制模板的命令：

  "scripts": {
    "build": "tsc && cp -r ./templates ./dist/templates"
  }
  

• 初始化email-templates时用绝对路径指定模板根目录，避免环境差异导致的路径解析问题：

  const path = require('path');
  const email = new Email({
    views: {
      root: path.resolve(__dirname, './templates')
    }
  });
  

2. 生产环境配置/环境变量缺失 #

开发环境可能直接写死了收件人地址，或者本地的环境变量加载正常，但生产服务器上的环境变量没配置对——比如收件人邮箱的变量为空，导致传递给Nodemailer的to参数是undefined。

解决办法：

• 检查生产环境的环境变量，确保收件人相关的配置（比如process.env.EMAIL_RECIPIENT）存在且不为空；
• 在发送邮件的代码里提前加校验，避免无效请求：

  const recipient = process.env.EMAIL_RECIPIENT;
  if (!recipient) {
    throw new Error('生产环境未配置收件人邮箱');
  }
  

3. 异步渲染流程没处理好 #

email-templates的渲染是异步操作，如果没等渲染完成就调用发送逻辑，可能导致收件人还没被正确注入到邮件配置里。

解决办法：

• 必须用async/await等待整个渲染+发送流程完成，不要用回调或者忽略Promise：

  async function sendWelcomeEmail(to) {
    const email = new Email({
      transport: yourNodemailerTransport,
      views: { root: path.resolve(__dirname, 'templates') }
    });
  
    // 务必用await等待发送完成
    await email.send({
      template: 'welcome',
      message: {
        to: to // 这里确保to参数有效
      },
      locals: { /* 模板变量 */ }
    });
  }
  

4. 模板内动态设置收件人踩坑 #

如果是在模板文件（比如html/text模板）里用动态变量设置收件人，生产环境下可能因为变量传递失败，导致email-templates无法生成正确的收件人配置。

解决办法：

• 尽量不在模板里设置收件人，而是直接在email.send()的message.to里明确指定，逻辑更清晰也更可靠；
• 如果必须在模板里动态设置，检查模板语法是否正确（比如ejs的<%= %>有没有写错），同时确保locals里的变量在生产环境下能正常传递。

调试小技巧 #

如果以上方法都没解决问题，可以开启Nodemailer的调试模式，查看详细的SMTP交互日志，帮你定位问题：

const transporter = nodemailer.createTransport({
  host: 'smtp.your-server.com',
  port: 587,
  secure: false,
  debug: true, // 开启调试模式
  auth: {
    user: process.env.EMAIL_USER,
    pass: process.env.EMAIL_PASS
  }
});

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