Node.js(TypeScript)中如何将URL路由:id参数直接读取为数字类型

首先明确：Express 框架默认将所有req.params路由参数解析为字符串类型，TypeScript 里的as number属于编译时类型断言，不会修改运行时的实际值，直接使用会导致 TypeORM 拿到字符串类型的ID，出现查询匹配失败的问题，不能靠类型断言跳过实际转换步骤。

你不需要在每个路由 handler 里重复写转换逻辑，只需要把转换逻辑抽成可复用的中间件即可，有两种常用实现方式：

方案1：全局参数自动转换（推荐） #

用Express内置的app.param方法，对所有名为id的路由参数统一做转换，一次配置所有路由生效：

1. 先在项目入口（app初始化之后、路由注册之前）添加全局参数处理逻辑：

// 全局拦截所有名为id的路由参数，自动转数字
app.param('id', (req, res, next, idValue) => {
  const parsedId = parseInt(idValue, 10);
  // 非法ID直接返回400参数错误，避免无效数据库查询
  if (isNaN(parsedId)) {
    return res.sendStatus(400);
  }
  // 重写params里的id为数字类型
  req.params.id = parsedId as any;
  next();
});

2. 为了让TypeScript正确识别id的类型，在项目的全局类型声明文件（比如src/global.d.ts）里扩展Express的Request类型：

declare namespace Express {
  interface Request {
    params: {
      id?: number;
      // 其他需要自动转数字的路由参数也可以在这里补充定义
    }
  }
}

3. 配置完成后，所有带:id的路由里可以直接解构拿到数字类型的id，直接传给TypeORM使用：

router.get('/users/:id', (req: Request, res: Response) => {
  const { id } = req.params;
  // id已经是number类型，无需额外转换
  userRepo.findOne({
    where: { id }
  })
})

方案2：路由组级别的参数转换 #

如果不想全局生效，只需要给特定路由组做转换，可以给对应路由添加专用中间件：

// 仅给/users前缀下带:id参数的路由做转换
router.use('/users/:id', (req, res, next) => {
  const parsedId = parseInt(req.params.id, 10);
  if (isNaN(parsedId)) {
    return res.sendStatus(400);
  }
  req.params.id = parsedId as any;
  next();
});

// 路由内直接使用即可
router.get('/users/:id', (req: Request, res: Response) => {
  const { id } = req.params;
  userRepo.findOne({ where: { id } })
})

注意事项 #

• 不要省略parseInt的第二个参数10，避免特殊格式的字符串（比如0x10）被默认解析为十六进制数值，出现ID转换错误。
• 必须在转换环节做NaN校验，避免非法路径参数（比如/users/abc）进入数据库查询逻辑。
• 不要单独使用as number做类型转换，该语法仅在TypeScript编译阶段生效，不会修改运行时的实际值，会导致查询逻辑异常。

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