Express中GET下载API无法识别URL参数id的问题求助

核心问题分析 #

你的问题源于路由层级的参数匹配冲突：当你在router.ts的router.use中添加:id，同时在download.ts的子路由里又定义/:id，最终形成的路由规则是/download/:id/:id，双重参数匹配会导致req.params.id拿到的是子路由匹配的空值，而非你期望的文件ID。

正确配置方案 #

1. 修复router.ts的路由挂载逻辑 #

不要在父路由的use方法中添加参数，只挂载基础路径，把参数匹配交给子路由处理：

// router.ts
import express from 'express';
import downloadRouter from './download';

const router = express.Router();
// 仅挂载基础路径，参数由子路由定义
router.use("/download/", downloadRouter);

export default router;

2. 保持download.ts的子路由定义不变 #

子路由的:id会自动拼接在父路由的/download/之后，形成正确的/download/:id路由规则：

// download.ts
import express from 'express';
import { authenticateUser } from './middleware/auth';

const router = express.Router();

router.get("/:id", authenticateUser, (req, res) => {
  const fileId = req.params.id; // 此处可正常获取URL中的id参数
  // 避免原报错的前置判断
  if (!fileId) {
    return res.status(400).json({ error: "文件ID不能为空" });
  }
  // 后续文件获取逻辑
});

export default router;

额外排查点 #

• 检查authenticateUser中间件：确保中间件没有篡改req.params对象，比如意外赋值或重置操作，会导致参数丢失。
• 验证请求URL格式：确认前端请求的是GET /download/xxx（xxx为实际文件ID），而非GET /download?id=xxx（这种是查询参数，需用req.query.id获取）。
• 确认路由顺序：如果router.ts中还有其他/download/相关路由，务必把router.use("/download/", downloadRouter)放在最前面，避免被其他路由规则提前拦截。

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