nestjs/nest · error

Unsupported route path: "${route}". In previous versions, th

Error message

Unsupported route path: "${route}". In previous versions, the symbols ?, *, and + were used to denote optional or repeating path parameters. The latest version of "path-to-regexp" now requires the use of named parameters. For example, instead of using a route like /users/* to capture all routes starting with "/users", you should use /users/*path. For more details, refer to the migration guide. Attempting to auto-convert to "${convertedRoute}"...

What it means

Error "Unsupported route path: "${route}". In previous versions, the symbols ?, *, and + were used to denote optional or repeating path parameters. The latest version of "path-to-regexp" now requires the use of named parameters. For example, instead of using a route like /users/* to capture all routes starting with "/users", you should use /users/*path. For more details, refer to the migration guide. Attempting to auto-convert to "${convertedRoute}"..." thrown in nestjs/nest.

Source

Thrown at packages/core/router/legacy-route-converter.ts:86

      );
      printWarning(route, convertedRoute);
      return convertedRoute;
    }

    return route;
  }

  static printError(route: string): void {
    this.logger.error(UNSUPPORTED_PATH_MESSAGE`${route}`);
  }

  static printWarning(route: string, convertedRoute?: string): void {
    // Surface the auto-converted result so users can map the flagged path to a
    // concrete fix, instead of only seeing the (often prefixed) offending path.
    const autoConvertMessage = convertedRoute
      ? ` Attempting to auto-convert to "${convertedRoute}"...`
      : ' Attempting to auto-convert...';
    this.logger.warn(UNSUPPORTED_PATH_MESSAGE`${route}` + autoConvertMessage);
  }
}

View on GitHub (pinned to dd75d7bd8c)

When it happens

Trigger: Thrown at packages/core/router/legacy-route-converter.ts:86 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of nestjs/nest@dd75d7bd8c (2026-08-21). Data as JSON: /api/errors/d71cb30ed54c1b38. Report an issue: GitHub.