NestJS中INestApplication无setBaseViewsDir方法，如何本地配置模板引擎？

核心原因：NestJS的适配器设计 #

NestJS是框架无关的，INestApplication是通用抽象接口，只包含所有HTTP适配器共有的方法。useStaticAssets、setBaseViewsDir这些是Express特有的方法，只有在使用NestExpressApplication类型时才能调用。

具体解决步骤 #

1. 切换到NestExpressApplication类型 #

创建应用时，明确指定使用Express适配器，并将应用实例类型声明为NestExpressApplication：

import { NestFactory } from '@nestjs/core';
import { NestExpressApplication } from '@nestjs/platform-express';
import { AppModule } from './app.module';

async function bootstrap() {
  // 创建Express类型的应用实例
  const app = await NestFactory.create<NestExpressApplication>(AppModule);
  
  // 现在可以调用Express专属的模板配置方法了
  app.useStaticAssets('public'); // 静态资源目录
  app.setBaseViewsDir('views'); // 模板文件存放目录
  app.setViewEngine('hbs'); // 示例用Handlebars引擎，需先安装对应依赖
  
  await app.listen(3000);
}
bootstrap();

2. 安装对应模板引擎依赖 #

以Handlebars为例，先安装依赖包：

npm install hbs

其他引擎（如EJS、Pug）逻辑类似，替换引擎名称和对应的依赖即可。

3. 本地渲染模板示例 #

在控制器中直接渲染本地模板，无需上传S3，还能随时加日志调试：

import { Controller, Get, Render } from '@nestjs/common';

@Controller()
export class AppController {
  @Get()
  @Render('index') // 对应views目录下的index.hbs文件
  root() {
    // 这里可以添加任意日志
    console.log('正在渲染首页模板，当前时间:', new Date());
    // 传递模板所需的变量
    return { pageTitle: '本地模板调试', content: '无需再看S3啦' };
  }
}

4. 本地调试跳过S3上传 #

如果原有逻辑是渲染后上传S3，本地开发时可以通过环境变量判断，跳过上传步骤：

import { ConfigService } from '@nestjs/config';

// 在处理模板的服务中
constructor(private configService: ConfigService) {}

async handleTemplate() {
  // 渲染模板逻辑
  const renderedHtml = await this.renderTemplate();
  
  // 根据环境决定是否上传S3
  if (this.configService.get('NODE_ENV') === 'production') {
    // 生产环境执行S3上传逻辑
  } else {
    // 本地开发直接打印或返回结果
    console.log('本地渲染结果:\n', renderedHtml);
    return renderedHtml;
  }
}

补充说明 #

NestJS默认用Express作为HTTP适配器，但为了实现框架无关性，抽象了INestApplication通用接口，所以必须显式使用NestExpressApplication才能访问Express的特定API。

内容的提问来源于stack exchange，提问作者Antonio Pavicevac-Ortiz