MongoDB中FindById返回null问题及ObjectId使用求助

核心问题分析 #

FindAll功能正常，能看到数据库中_id是ObjectId类型（日志显示new ObjectId('6339e6a9b552ad1128601096')），但FindById查询时用字符串格式的req.params.id直接匹配，无法匹配数据库中的ObjectId类型字段，因此返回null。

你之前尝试findOne({ _id: ObjectId(req.params.id) })报错，是因为没有用new关键字实例化ObjectId对象。

修复方案 #

1. 正确导入ObjectId #

从MongoDB包中导入ObjectId（以下为MongoDB驱动v4+版本的示例导入方式）：

import { ObjectId } from 'mongodb';

2. 修改FindById函数 #

构建查询条件时，用new ObjectId()将字符串id转换为ObjectId类型，同时增加无效id格式的错误处理：

async function findById(req, res) {
    let games = await db.collection("games");
    
    try {
        // 将字符串id转换为ObjectId类型
        let query = { _id: new ObjectId(req.params.id) };
        console.log('query', query)

        let result = await games.findOne(query);
        console.log('result', result)

        if (result) {
            res.send(result).status(200);
        } else {
            res.send("Game Not Found").status(404);
        }
    } catch (err) {
        // 处理无效格式的id
        res.send("Invalid Game ID Format").status(400);
    }
}

修复原理 #

MongoDB存储文档时，_id字段默认是ObjectId对象类型，而非字符串。直接用字符串id匹配时，因类型不匹配导致查询无结果。通过new ObjectId(req.params.id)将字符串转换为对应ObjectId对象，才能和数据库中的字段正确匹配。

添加try/catch块是为了处理用户传入非法格式id的情况（比如长度不符、字符不合法），避免程序崩溃。

修复后预期日志 #

修改后，FindById的query日志会变为：

query { _id: new ObjectId('6339e6a9b552ad1128601096') }

此时能正确匹配到目标文档，result不会再返回null。

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