NestJS MVC控制器中如何正确定义子文件夹模板路径？

核心问题原因 #

使用@Render('path/to/template')返回404，通常是模板根目录配置错误或文件路径/扩展名不匹配导致NestJS无法定位到模板文件。

正确配置步骤 #

1. 确认模板引擎根目录配置 #

在AppModule的configure方法中，必须指定模板文件的根目录，NestJS会基于这个根目录去查找@Render中指定的子路径。

以Handlebars为例，配置示例：

import { Module } from '@nestjs/common';
import { NestExpressApplication } from '@nestjs/platform-express';
import { HandlebarsAdapter } from '@nestjs/handlebars';
import { AppController } from './app.controller';
import { join } from 'path';

@Module({
  controllers: [AppController],
})
export class AppModule {
  configure(app: NestExpressApplication) {
    // 指向项目根目录下的views文件夹（根据实际结构调整路径）
    app.setBaseViewsDir(join(process.cwd(), 'views'));
    // 设置模板引擎（这里用hbs对应Handlebars）
    app.setViewEngine('hbs');
    app.engine('hbs', new HandlebarsAdapter());
  }
}

2. 匹配模板文件结构 #

假设项目模板结构如下：

项目根目录/
├── src/
│   └── app/
│       ├── app.controller.ts
│       └── app.module.ts
└── views/
    ├── index.hbs
    └── path/
        └── to/
            └── template.hbs

此时@Render('path/to/template')会正确匹配views/path/to/template.hbs文件，不需要加扩展名（NestJS会根据配置的模板引擎自动识别）。

3. 常见错误排查 #

• 路径拼写错误：检查文件夹/文件名的大小写（Linux系统区分大小写）、拼写是否一致。
• 依赖缺失：确保已安装对应模板引擎的依赖，比如Handlebars需要安装hbs、@nestjs/handlebars、@nestjs/platform-express。
• 根目录配置错误：如果模板放在src/views下，就把setBaseViewsDir的路径改为join(__dirname, '..', 'views')。

正确控制器代码示例 #

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

@Controller()
export class AppController {
  @Get()
  @Render('index')
  findAll() {
    return {};
  }

  @Get('sub-page')
  @Render('path/to/template')
  getSubPage() {
    // 可传递模板变量
    return { title: '子页面标题', content: '这是子模板的内容' };
  }
}

内容的提问来源于stack exchange，提问作者markovpavel.ru