MVC架构下req.params.id显示undefined，无法获取Mongo产品_id

问题背景 #

需要将MongoDB文档的_id作为产品ID，但访问对应页面时，打印req.params.id结果为undefined，项目采用MVC架构，相关代码如下：

路由定义

// get request://
router.get("/shop/:id", userController.shopPage)

控制器方法

// route://
getProductPage: (req, res) => {
  try{
    let proId = req.params.id;
    console.log(proId)
    productHelpers
    .getProduct(proId)
    .then((products) => {
     
      res.render("user/view-product",{products}); 
    })
  } catch(error){
    // 建议添加错误日志便于排查
  }
}

数据层方法

//get Product//
getProduct: (proId) => {
  console.log(proId)
  return new Promise((resolve, reject) => {
    try {
      db.products.find({_id:proId}).then((products) => {
        resolve(products);
      });
    } catch (error) {
      console.log(error);
    }
  });
},

问题排查与修复方案 #

1. 路由与控制器方法不匹配（核心问题）

路由中指定的控制器方法是userController.shopPage，但实际定义的处理方法是getProductPage，导致请求根本没有进入正确的逻辑分支，自然无法获取req.params.id。

修复：
修改路由配置，指向正确的控制器方法：

router.get("/shop/:id", userController.getProductPage);

2. 访问URL不符合路由规则

如果访问的是/shop而非/shop/[产品ID]（例如/shop/60d21b4667d0d8992e610c85），路由的:id参数不会被匹配，req.params.id就会是undefined。

修复：
确保访问的URL格式正确，必须携带产品ID，示例格式：http://your-domain/shop/60d21b4667d0d8992e610c85

3. MongoDB _id类型不匹配（后续潜在问题）

MongoDB的_id是ObjectId类型，直接用字符串查询会返回空结果，即使proId能正确获取，也查不到目标数据。

修复（Mongoose场景）：
将字符串转换为ObjectId类型后再查询：

const mongoose = require('mongoose');

// 在getProduct方法中修改查询条件
db.products.find({_id: mongoose.Types.ObjectId(proId)}).then((products) => {
  resolve(products);
});

修复（MongoDB原生驱动场景）：

const { ObjectId } = require('mongodb');

// 在getProduct方法中修改查询条件
db.products.find({_id: new ObjectId(proId)}).then((products) => {
  resolve(products);
});

4. 错误处理优化

原代码中catch块为空，无法排查内部错误，建议补充错误日志和响应处理：

getProductPage: (req, res) => {
  try{
    let proId = req.params.id;
    console.log(proId)
    productHelpers
    .getProduct(proId)
    .then((products) => {
      res.render("user/view-product",{products}); 
    })
    .catch(err => {
      console.error('获取产品失败:', err);
      res.status(500).send('获取产品失败');
    })
  } catch(error){
    console.error('控制器错误:', error);
    res.status(500).send('服务器错误');
  }
}

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