nodemailer结合handlebars发邮件报无法查找orders视图错误

该报错本质是nodemailer-express-handlebars插件无法在指定路径下找到匹配的邮件模板，共有3处直接诱因，对应修复方式如下：

• 1. 模板路径使用相对路径导致匹配失败 #

  你在mailer.js中配置的viewPath:'./views/'是相对路径，Node运行时相对路径参照的是执行启动命令的工作目录，而非mailer.js文件所在目录，启动目录变化时就会出现路径错位。
  修复方式：改用绝对路径，和服务端视图配置逻辑保持一致。
  首先在mailer.js顶部补充依赖和ES模块下的路径常量（你用的是ESM import语法，原生不提供__dirname变量）：

  import path from 'path';
  import { fileURLToPath } from 'url';
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = path.dirname(__filename);
  

  然后修改hbs插件的配置段：

  transporter.use('compile', hbs({
    viewEngine: {
      extname: '.hbs',
      defaultLayout: false // 邮件模板无需套用公共layout，关闭避免额外报错
    },
    viewPath: path.join(__dirname, 'views'),
    extName: '.hbs'
  }))
  

• 2. 多余的res.render调用干扰逻辑 #

  你在订单查询回调里写的res.render('orders', {data:orderData})是Express用来给HTTP响应返回渲染页面的方法，和nodemailer的邮件模板渲染是完全独立的两套逻辑。这段代码会抢在邮件发送前返回HTTP响应，且上下文不匹配触发视图查找错误。
  修复方式：删掉这段多余的res.render逻辑，统一用async/await写法查询订单，把模板数据通过邮件配置的context字段传入：

  // 替换原来混用await和回调的订单查询逻辑
  const orderData = await Order.findById(orderId)
  if(!orderData) {
    res.status(404).send({message: '订单不存在'})
    return
  }
  

  同时修改mailOptions配置，删掉和HTML模板冲突的纯文本text字段，补充context传参：

  const mailOptions = {
    from: sender, 
    to: em, 
    subject: sub, 
    template: 'orders',
    context: {
      data: orderData
    }
  }
  

• 3. 视图引擎配置不匹配 #

  你原来给hbs插件传的viewEngine: 'express-handlebars'是旧版本的简写写法，v6以上版本的express-handlebars不支持这种字符串传参，插件会默认查找.handlebars后缀的文件，无法识别你存的.hbs后缀模板。
  该问题的修复已经包含在第一点的viewEngine对象配置中，明确指定后缀名即可。

改完以上三点重启服务，就能正常加载模板渲染订单邮件内容。

内容的提问来源于stack exchange，提问作者pelotador.1