Mongoose CastError排查：无法将字符串'new'转为ObjectId

报错核心问题 #

你遇到两个关联问题：

• CastError: Cast to ObjectId failed for value "new"：路由匹配顺序错误导致"new"被当作ObjectId参数处理
• UnhandledPromiseRejectionWarning：异步路由中未捕获Promise异常

1. 解决CastError问题 #

问题根源 #

Express路由匹配遵循从上到下的顺序优先级，你当前把/products/:id放在/products/new前面，访问/products/new时，Express会将"new"解析为:id的参数值，传给Product.findById(id)，但"new"不是有效的MongoDB ObjectId格式，因此抛出类型转换错误。

修复步骤 #

将/products/new路由移到/products/:id路由之前，确保具体路由优先于动态参数路由被匹配：

修改后的路由代码片段：

// 先定义具体的/new路由
app.get('/products/new',(req , res)=>{
  res.render('data/new');
});

// 再定义动态id路由
app.get('/products/:id' , async (req , res)=>{
  const {id} = req.params;
  const product = await Product.findById(id);
  res.render('data/detail' , {product});
});

2. 解决未处理Promise拒绝警告 #

问题根源 #

所有使用await的异步路由处理函数（比如根路由和商品详情路由）没有捕获Promise可能抛出的异常，当数据库查询失败（如无效ObjectId、数据库连接中断）时，Promise被拒绝但无处理逻辑，触发警告。

修复步骤 #

给所有异步路由添加try/catch块捕获异常，同时补充商品不存在的判断逻辑：

修改后的异步路由代码：

app.get('/', async (req, res)=>{
  try {
    const data = await Product.find({});
    res.render('data/showData' , {data})
  } catch (err) {
    res.status(500).send(`获取商品列表失败：${err.message}`);
  }
});

app.get('/products/:id' , async (req , res)=>{
  try {
    const {id} = req.params;
    const product = await Product.findById(id);
    // 处理商品不存在的场景
    if (!product) {
      return res.status(404).send('未找到该商品');
    }
    res.render('data/detail' , {product});
  } catch (err) {
    res.status(500).send(`获取商品详情失败：${err.message}`);
  }
});

另外，数据库连接函数可简化（去掉冗余的then/catch，利用await+try/catch统一处理）：

const connectdB = async function () {
  try {
    await mongoose.connect("mongodb://localhost:27017/shopApp");
    console.log("connected to database");
  } catch (err) {
    console.log('数据库连接失败：', err);
  }
};
connectdB();

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