如何从远程位置加载Nodemailer邮件的Handlebar模板

我有一个NestJS应用，包含POST /email端点，该端点会根据API调用中指定的模板（template=xxx），结合Nodemailer和Handlebar模板发送邮件。示例请求：http://localhost:3000/email?to=test@gmail.com&name=John&template=email2。

当前Handlebar模板静态存储在./templates文件夹中，我希望能从远程位置（比如S3桶）加载这些模板，以便灵活地添加、编辑和删除模板。我设想的流程如下方序列图所示：

请问这种方式是否可行？或者有其他替代方案？

我的NestJS配置非常简单，静态Handlebar模板位于src/template文件夹中，核心代码如下：

// app.module.ts
@Module({
    imports: [
        ConfigModule.forRoot(),
        MailerModule.forRootAsync({
            imports: [ConfigModule],
            useFactory: async (config: ConfigService) => {
                return {
                    transport: {
                        host: config.get('EMAIL_HOST'),
                        secure: false,
                        auth: {
                            user: config.get('EMAIL_USER'),
                            pass: config.get('EMAIL_PASSWORD'),
                        },
                    },
                    defaults: {
                        from: 'info@test.de',
                    },
                    template: {
                        dir: join(__dirname, './templates'),
                        adapter: new HandlebarsAdapter(),
                        options: {
                            strict: true,
                        },
                    },
                };
            },
            inject: [ConfigService],
        }),
    ],
    controllers: [AppController],
    providers: [AppService],
})
export class AppModule {}

// app.controller.ts
@Controller()
export class AppController {
    constructor(private mailerService: MailerService) {}

    @Post('/email')
    async getHello(
        @Query('to') to: string,
        @Query('name') name: string,
        @Query('template') template: string,
    ): Promise<SentMessageInfo> {
        const info = await this.mailerService.sendMail({
            to,
            subject: 'Greeting from NestJS NodeMailer',
            template,
            context: {
                name,
            },
        });
        console.log('Preview URL: %s', getTestMessageUrl(info));
    }

一、你设想的远程加载模板方案完全可行 #

从序列图逻辑来看，流程清晰合理，具体实现可参考以下步骤：

1. 封装远程模板加载服务
   创建一个TemplateLoaderService，负责从S3或其他存储服务拉取模板内容：

import { Injectable } from '@nestjs/common';
import { S3 } from 'aws-sdk';
import { ConfigService } from '@nestjs/config';

@Injectable()
export class TemplateLoaderService {
  private s3: S3;

  constructor(private configService: ConfigService) {
    this.s3 = new S3({
      accessKeyId: this.configService.get('AWS_ACCESS_KEY'),
      secretAccessKey: this.configService.get('AWS_SECRET_KEY'),
      region: this.configService.get('AWS_REGION'),
    });
  }

  async getTemplate(templateName: string): Promise<string> {
    const params = {
      Bucket: this.configService.get('S3_TEMPLATE_BUCKET'),
      Key: `${templateName}.hbs`,
    };
    const response = await this.s3.getObject(params).promise();
    return response.Body.toString('utf-8');
  }
}

2. 绕过静态模板目录，手动编译模板
   不再依赖MailerModule配置的template.dir，手动用Handlebars编译远程拉取的模板内容后发送邮件：

import { Controller, Post, Query } from '@nestjs/common';
import { MailerService } from '@nestjs-modules/mailer';
import * as Handlebars from 'handlebars';
import { TemplateLoaderService } from './template-loader.service';
import { getTestMessageUrl } from 'nodemailer';
import { SentMessageInfo } from 'nodemailer/lib/smtp-transport';

@Controller()
export class AppController {
  constructor(
    private mailerService: MailerService,
    private templateLoaderService: TemplateLoaderService,
  ) {}

  @Post('/email')
  async sendEmail(
    @Query('to') to: string,
    @Query('name') name: string,
    @Query('template') template: string,
  ): Promise<SentMessageInfo> {
    // 1. 从远程拉取模板内容
    const templateContent = await this.templateLoaderService.getTemplate(template);
    // 2. 编译Handlebars模板
    const compiledTemplate = Handlebars.compile(templateContent);
    // 3. 渲染模板内容
    const html = compiledTemplate({ name });
    // 4. 发送邮件
    const info = await this.mailerService.sendMail({
      to,
      subject: 'Greeting from NestJS NodeMailer',
      html, // 直接传入渲染后的HTML
    });
    console.log('Preview URL: %s', getTestMessageUrl(info));
    return info;
  }
}

3. 添加缓存优化
   为避免每次请求都拉取远程模板，可使用cache-manager添加内存缓存，减少远程调用次数：

import { CACHE_MANAGER } from '@nestjs/cache-manager';
import { Inject, Injectable } from '@nestjs/common';
import { Cache } from 'cache-manager';

// 在TemplateLoaderService的getTemplate方法中添加缓存逻辑
async getTemplate(templateName: string): Promise<string> {
  const cacheKey = `template:${templateName}`;
  const cachedTemplate = await this.cacheManager.get<string>(cacheKey);
  if (cachedTemplate) {
    return cachedTemplate;
  }
  // 拉取远程模板的逻辑...
  await this.cacheManager.set(cacheKey, templateContent, 3600); // 缓存1小时
  return templateContent;
}

二、替代方案：模板服务化 #

如果需要更完善的模板管理能力（如版本控制、预览、权限校验），可以单独搭建模板服务，提供REST接口供NestJS应用调用获取模板内容。这种方式的优势：

• 独立维护模板的编辑、审核、发布生命周期
• 支持模板版本回滚
• 可添加访问控制，避免非法模板调用

三、注意事项 #

• 异常处理：需处理模板拉取失败、模板不存在等场景，返回明确的错误提示
• 模板安全：对模板内容做安全校验，防止注入恶意代码
• 性能优化：除缓存外，可提前预热高频使用的模板到内存

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