NestJS同一模块下同一控制器配置两条独立路由出现404如何解决？

两个路由完全可以放在同一个模块下实现，你遇到的404问题是路由匹配逻辑、代码语法错误共同导致的，具体排查修复步骤如下：

核心问题根因 #

• 缺少匹配目标路由的处理逻辑
  你将PreferenceModule同时挂载在/api/items和/api/features两个路径前缀下，但控制器中没有对应前缀根路径的@Get()处理方法，访问/api/items时自然无法匹配到路由。
• 现有路由与需求不匹配
  你写的@Get('preference/:x/:y/:z')对应的完整路径是/api/items/preference/xxx/yyy/zzz，和你需要的/api/items完全不符；而@Get(':id')仅能匹配/api/features/xxx这类带后缀参数的路径，这也是你说第二个路由可以正常访问的原因。
• 模块注册语法错误（如果实际代码和示例一致）
  @Module的controllers和providers数组需要传入类引用，不能传字符串，否则Nest依赖注入会失效。

修复步骤 #

1. 修正控制器逻辑 #

增加对应根路径的路由处理，根据请求路径区分返回商品/功能偏好列表：

import { Controller, Get, Req, Param } from '@nestjs/common';
import { Request } from 'express';
import { PreferenceService } from './preference.service';

@Controller()
export class PreferenceController{
    constructor(private readonly preferenceService: PreferenceService) {}

    // 匹配模块前缀根路径，即 /api/items 和 /api/features
    @Get()
    getPreferenceList(@Req() req: Request) {
        if (req.path.includes('/items')) {
            // 返回商品偏好列表
            return this.preferenceService.getItemList();
        }
        if (req.path.includes('/features')) {
            // 返回功能偏好列表
            return this.preferenceService.getFeatureList();
        }
    }

    // 保留原有带参数的接口（可根据实际需求调整）
    @Get('preference/:x/:y/:z')
    getItem(@Param() param) {
        return this.preferenceService.getItem(param);
    }

    @Get(':id')
    getFeature(@Param() param) {
        return this.preferenceService.getFeature(param);
    }
}

2. 修正模块注册代码 #

将字符串改为类引用，保证依赖注入正常工作：

import { Module } from '@nestjs/common';
import { PreferenceController } from './preference.controller';
import { PreferenceService } from './preference.service';

@Module({
  controllers: [PreferenceController],
  providers: [PreferenceService]
})
export class PreferenceModule {}

3. 修正路由配置 #

如果使用RouterModule注册路由前缀，确保传入正确的类引用：

import { PreferenceModule } from './preference/preference.module';

const routes = [
  {
    path: 'api',
    children: [
      {
        path: 'items',
        module: PreferenceModule
      },
      { 
        path: 'features',
        module: PreferenceModule
      }
    ]
  }
];

// 根模块imports中添加 RouterModule.register(routes)

更简化的实现方式 #

如果不需要拆分模块前缀，可直接在控制器指定路由，无需额外配置RouterModule：

@Controller('api')
export class PreferenceController{
    @Get('items')
    getItemList() {
        return this.preferenceService.getItemList();
    }

    @Get('features')
    getFeatureList() {
        return this.preferenceService.getFeatureList();
    }

    // 其余接口保留即可
}

验证 #

修复完成后访问以下地址测试：

• GET /api/items → 返回商品偏好列表
• GET /api/features → 返回功能偏好列表

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