如何在NestJS中实现同路径多路由以支持功能开关、AB测试场景

方案1：顶层路由分发（最简单易维护，推荐用于功能开关场景） #

不用依赖NestJS原生路由fallback能力，直接把同路径的逻辑入口统一，在入口层做开关判定：

• 删掉两个控制器里重复的/checkout路由定义，单独在公共控制器或者任意一个控制器里只定义一次/checkout路由
• 路由内部先做权限/开关判定，符合新版使用条件的就调用BasketControllerNew的对应处理方法，不符合就调用BasketController的旧版处理方法

示例代码：

@Controller()
export class CheckoutRouterController {
  constructor(
    private readonly newBasketController: BasketControllerNew,
    private readonly oldBasketController: BasketController
  ) {}

  @Post('/checkout')
  async checkout(@Req() req: Request, @Body() body: any) {
    const isNewVersionAllowed = checkUserFeatureToggle(req.user.id);
    if (isNewVersionAllowed) {
      return this.newBasketController.checkout(req, body);
    }
    return this.oldBasketController.checkout(req, body);
  }
}

这个方案无黑魔法，调试维护成本极低，完全满足功能开关的需求，同时支持动态调整开关规则。

方案2：自定义异常+中间件实现路由fallback（满足异常触发下一个路由的需求） #

NestJS原生路由匹配按模块加载顺序执行，先注册的路由优先匹配，你可以通过自定义中间件捕获你定义的DisabledRouteException，强制转发到下一个同路径路由：

1. 先定义自定义异常

export class DisabledRouteException extends Error {
  constructor() {
    super('Route disabled, try next match');
  }
}

2. 写全局中间件，在中间件里包裹路由执行逻辑，捕获到DisabledRouteException时跳过当前路由，让Express/Fastify继续匹配下一个同路径路由
   以Express为例的中间件示例：

import { NextFunction, Request, Response } from 'express';

export function routeFallbackMiddleware(req: Request, res: Response, next: NextFunction) {
  const originalNext = next;
  // 重写next方法捕获自定义异常
  next = (err?: any) => {
    if (err instanceof DisabledRouteException) {
      // 跳过当前路由，匹配下一个
      return originalNext('route');
    }
    return originalNext(err);
  };
  originalNext();
}

3. 在主模块注册这个全局中间件，注意要注册在所有路由之前

export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer.apply(routeFallbackMiddleware).forRoutes('*');
  }
}

4. 守卫里如果判定路由不可用，直接抛出DisabledRouteException即可，框架会自动匹配下一个同路径的路由
   这个方案完全符合你期望的通过异常触发下一个路由匹配的需求，也适配你提到的CMS通配符路由场景。

方案3：通配符路由兜底（适配CMS静态页fallback场景） #

针对你提到的moduleA未开通时返回CMS静态页的场景，可以单独定义一个优先级最低的通配符路由兜底，所有未匹配到或者未开通的路由都会走到这个兜底逻辑：

• 兜底路由的路径定义为*，放在所有控制器的最后注册（NestJS会按模块加载顺序匹配路由，越晚注册的路由优先级越低）
• 兜底路由内部可以根据请求路径查询对应CMS静态内容返回即可

示例代码：

@Controller()
export class CmsFallbackController {
  @Get('*')
  async cmsFallback(@Req() req: Request) {
    const path = req.path;
    // 查询CMS对应路径的静态内容返回，没有就返回404
    return getCmsPageContent(path) ?? new NotFoundException();
  }
}

• NestJS默认路由匹配顺序和控制器/模块的加载顺序完全一致，同路径的路由要把优先级高的（比如新版功能路由）放在前面加载，优先级低的放在后面加载
• 如果用Fastify作为底层框架，路由匹配逻辑和Express略有差异，方案2的中间件需要对应调整为Fastify的钩子实现

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