Nodemailer未按指定viewPath查找模板的问题求助

核心原因 #

你遇到的问题大概率是nodemailer-express-handlebars的配置不完整，导致引擎没有正确识别viewPath参数，转而使用当前工作目录作为模板查找路径。

具体修复步骤 #

1. 补全完整的handlebars引擎配置

确保将viewPath和viewEngine的目录参数正确绑定，示例代码如下：

const nodemailer = require('nodemailer');
const hbs = require('nodemailer-express-handlebars');

// 创建邮件 transporter
const transporter = nodemailer.createTransport({
  // 你的邮件服务配置（如SMTP信息）
  host: 'smtp.example.com',
  port: 587,
  auth: {
    user: 'your-email@example.com',
    pass: 'your-password'
  }
});

// 配置handlebars模板引擎
const handlebarOptions = {
  viewEngine: {
    extName: '.handlebars',
    // 模板所在目录（与viewPath一致）
    partialsDir: '/home/honda/develoment/phaser_projects/test/templates',
    layoutsDir: '/home/honda/develoment/phaser_projects/test/templates',
    defaultLayout: false // 不需要默认布局时设为false，避免引擎去默认路径查找
  },
  viewPath: '/home/honda/develoment/phaser_projects/test/templates',
  extName: '.handlebars'
};

// 将引擎绑定到transporter
transporter.use('compile', hbs(handlebarOptions));

2. 发送邮件时使用template字段指定模板

发送邮件时，用template字段传入模板文件名（不带后缀），不要使用path字段，否则会忽略viewPath：

transporter.sendMail({
  from: 'sender@example.com',
  to: 'recipient@example.com',
  subject: '测试HTML邮件',
  template: 'main' // 对应templates目录下的main.handlebars文件
}, (err, info) => {
  if (err) console.error(err);
  else console.log('邮件发送成功:', info.response);
});

3. 验证路径与版本

• 用fs模块确认模板文件存在：

  const fs = require('fs');
  const templatePath = '/home/honda/develoment/phaser_projects/test/templates/main.handlebars';
  console.log(fs.existsSync(templatePath)); // 应返回true
  

• 升级依赖到最新版本，避免旧版本的路径处理bug：

  npm update nodemailer nodemailer-express-handlebars
  

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