从Jest切换到Vitest后，NestJS所有路由返回500内部服务器错误

以下是几个常见原因及对应的解决方法：

1. 缺少Node.js环境配置 #

Vitest默认不会自动启用Node.js环境，而NestJS运行依赖Node.js的特性（如反射、文件系统访问）。需在vitest.config.ts中显式指定环境：

import { defineConfig } from 'vitest/config';
import nestjs from '@nestjs/vitest';

export default defineConfig({
  plugins: [nestjs()],
  test: {
    environment: 'node', // 必须配置此项
    globals: true, // 可选：开启后无需手动导入describe/it/beforeEach
  },
});

2. 未使用NestJS官方Vitest插件 #

官方的@nestjs/vitest插件专门适配NestJS测试生命周期，缺少它可能导致模块编译、依赖注入等环节异常：

• 先安装插件：

  npm install @nestjs/vitest --save-dev
  

• 再在vitest配置中引入插件（如上一步代码示例）。

3. 异步测试处理不规范 #

虽然Vitest支持返回Promise的测试写法，但显式使用async/await能避免潜在的异步时序问题，建议修改测试用例：

it('/ (GET)', async () => {
  await request(app.getHttpServer()).get('/endpoint').expect(200).expect(':)');
});

4. 排查应用初始化异常 #

多数500错误源于应用初始化失败，在beforeEach中添加错误捕获直接定位问题：

beforeEach(async () => {
  try {
    const moduleFixture: TestingModule = await Test.createTestingModule({
      imports: [AppModule],
    }).compile();

    app = moduleFixture.createNestApplication();
    await app.init();
  } catch (err) {
    console.error('应用初始化失败:', err);
    throw err; // 抛出错误让测试失败，同时打印详细异常信息
  }
});

5. 环境变量加载问题 #

如果NestJS应用依赖环境变量，Vitest的加载逻辑和Jest不同，可通过dotenv手动加载：

// 在vitest.config.ts顶部添加
import { config } from 'dotenv';
config(); // 加载.env文件中的环境变量

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