NestJS e2e测试POST接口预期201实际返回404问题

问题复现 #

• 场景：编写用户偏好创建接口e2e测试用例时，用例AppController (e2e) › / (POST - create new user preferences)执行失败
• 报错表现：
  • 调用POST /api/v1/user-preferences预期返回201 Created，实际返回404 Not Found
  • 断言错误信息：expect(received).toBe(expected) // Object.is equality
  • 接口返回文本：Cannot POST /api/v1/user-preferences
• 已确认现状：
  • 已配置env.test测试环境变量，测试运行时Mongo Atlas会自动创建新集合
  • 移除mongoose.connection.db.dropDatabase();清库逻辑后，集合内依然无数据写入
  • 同接口在Postman中可正常完成全部CRUD操作
  • 排查附件包含e2e测试文件完整代码、Postman调用路径、接口完整响应日志

修复步骤（按优先级排查） #

1. 优先检查测试环境全局前缀配置
   这是该类问题最高发原因：你在main.ts里配置了app.setGlobalPrefix('api/v1')，但e2e测试文件初始化app实例时没有加相同配置，导致测试环境的路由根本没有/api/v1前缀，请求带前缀路径自然匹配不到。
   修复方式：在测试文件的app初始化逻辑中，和main.ts保持完全一致的全局配置：

   const app = moduleFixture.createNestApplication();
   // 这行必须加，和main.ts里的前缀配置完全一致
   app.setGlobalPrefix('api/v1');
   // 如果你main.ts里开了版本化，这里也要加完全一样的enableVersioning配置
   await app.init();
   

2. 检查测试模块的依赖引入
   打开e2e测试文件的Test.createTestingModule配置段，确认承载user-preferences接口的业务模块（通常是UserPreferencesModule）被正确引入。如果你的根AppModule没有自动导出/引入该业务模块，测试环境仅加载AppModule时不会注册对应路由。
   正确引入示例：

   const moduleFixture: TestingModule = await Test.createTestingModule({
     imports: [
       AppModule,
       // 确认你的业务模块在这里被引入，不要漏
       UserPreferencesModule,
       MongooseModule.forRoot(process.env.MONGO_TEST_URI)
     ],
   }).compile();
   

3. 验证路由是否真实注册
   在await app.init()之后加如下代码，运行测试时会打印所有已注册的HTTP路由，直接确认目标路由是否存在：

   const server = app.getHttpServer();
   const routerStack = server._events.request._router.stack;
   const routes = routerStack
     .filter(layer => layer?.route)
     .map(layer => `${Object.keys(layer.route.methods).join(',').toUpperCase()} ${layer.route.path}`);
   console.log('测试环境已注册路由:\n', routes.join('\n'));
   

   • 如果输出里找不到POST /api/v1/user-preferences，回到上一步检查模块、Controller的注册
   • 如果输出里有该路由依然报404，检查supertest的请求路径是否多写/漏写斜杠，是否遗漏了必要的请求头（比如Content-Type: application/json）
4. Mongo集合空数据问题说明
   测试运行时Mongo创建集合但无数据是路由匹配失败的连带现象：Mongoose初始化连接时会自动创建关联的集合，但请求根本没走到Controller/Service的业务逻辑，自然不会触发数据写入，路由问题修复后该现象会自动消失，不需要额外调整数据库配置。

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