NestJS中@Get(':key')空参数时指向@Get() 如何区分两个接口

问题根因 #

NestJS 底层依赖 Express 或 Fastify 框架，路由匹配遵循先定义先匹配规则，且会优先命中完全匹配的路由规则。你请求的 http://testapp/testroute/ 路径完全匹配无参数的 @Get() 路由，所以请求根本不会进入带 :key 参数的路由逻辑，你给 KeyParamsDto 加的校验规则自然没有触发机会。

解决方案 #

你可以根据自身业务需求选择以下任意一种方案：

• 方案1：调整路由定义顺序，将带参数路由放在前面，同时将参数设为可选，让空路径也能命中参数路由
  调整后的控制器代码示例：

  @Controller('testapp/testroute')
  export class TestController {
    // 带参数路由放在前面，加?标识key为可选参数，空路径也可匹配该路由
    @Get(':key?')
    getOne(@Param() params: KeyParamsDto) {
      // 单条查询业务逻辑
    }
  
    @Get()
    getAll() {
      // 全量查询业务逻辑
    }
  }
  

  调整后空路径请求会先命中 @Get(':key?') 路由，触发 class-validator 校验，@IsNotEmpty() 规则会直接抛出参数为空的 400 错误，完全符合你的预期。

• 方案2：直接删除无参数的 @Get() 路由
  如果你不需要保留 GET /testapp/testroute/ 返回全量数据的能力，直接删除该路由即可，所有对应前缀的路径请求都会进入带 :key 的路由，空参数会自动触发校验报错。

• 方案3：给全量查询接口加明确路径，避免路由冲突（最推荐）
  按照 RESTful 接口设计规范，给全量查询接口指定独立路径，彻底避免路由匹配歧义：

  @Controller('testapp/testroute')
  export class TestController {
    @Get(':key')
    getOne(@Param() params: KeyParamsDto) {
      // 单条查询业务逻辑
    }
  
    // 全量查询用明确路径标识
    @Get('list')
    getAll() {
      // 全量查询业务逻辑
    }
  }
  

  调整后只有 GET /testapp/testroute/list 会返回全量数据，其余所有 /testapp/testroute/xxx 路径都会进入单条查询逻辑，空路径请求会触发参数校验抛出错误，路由逻辑完全清晰无冲突。

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