使用req.params.id查询MongoDB用户报Cast to ObjectId错误如何解决？

错误原因 #

MongoDB 默认的 _id 字段为 ObjectId 类型，要求值必须是24位十六进制格式的字符串。你传入的参数值为 "0"，不符合格式要求，Mongoose 执行查询前做自动类型转换失败，因此抛出该错误。

解决方案 #

分两种适用场景选择对应方案：

场景1：使用 MongoDB 默认生成的 ObjectId 作为主键 #

你需要先校验传入的 ID 格式合法性，再手动转换为 ObjectId 类型执行查询，修改后代码如下：

// 顶部引入 mongoose 的类型工具
const { Types } = require('mongoose');

app.get('/user/:id', (req,res) => {
    const targetId = req.params.id;
    // 提前校验格式，非法参数直接返回400
    if (!Types.ObjectId.isValid(targetId)) {
        return res.status(400).send('用户ID格式非法');
    }
    Users.findOne({_id: Types.ObjectId(targetId)}, (err,user) => { 
        if(!err) {                                      
            res.send(user)                          
            console.log(user);
        } else {
            console.log(err);
            res.status(500).send('Error Happened')
        }
    })
})

同时需要检查前端传参逻辑，确保传递的是 MongoDB 中实际存储的24位 _id 值，而非 0 这类自定义序号。

场景2：自定义 _id 为数字/普通字符串类型 #

如果你的业务是自行指定 _id 取值（比如用自增数字作为用户ID），需要修改 Users 模型的 schema 定义，明确指定 _id 的字段类型：

// 示例：指定_id为数字类型，用字符串ID就替换为String
const userSchema = new mongoose.Schema({
  _id: Number,
  name: String,
  email: String,
  address: String
})
const Users = mongoose.model('Users', userSchema);

修改完成后直接传字符串格式的自定义ID即可正常查询。

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