Node.js中MongoDB+Mongoose按ID更新课程失败，提示找不到课程

问题背景 #

在Node.js环境中使用Mongoose操作MongoDB课程数据库时，调用updateCourse函数传入已存在的课程ID（如5a68fdd7bee8ea64649c2777），始终返回“Course not found”，但getCourses函数能正常查询到包含该ID的课程，按名称查询也能成功。

潜在原因及解决方案 #

1. 数据库连接未完成就执行查询 #

从输出顺序可以看到：

checking..
Connected to MongoDB...
Course not found

updateCourse在数据库连接建立前就执行了查询操作。Mongoose的连接是异步的，此时Course.findById(id)会在未连接成功的状态下执行，自然无法找到数据。

解决方案：
确保在数据库连接完成后再调用updateCourse，可以将调用逻辑放到连接的then回调中：

mongoose.connect("mongodb://localhost:27017/mongo-exercise")
.then( ()=> {
    console.log("Connected to MongoDB...");
    updateCourse('5a68fdd7bee8ea64649c2777'); // 连接成功后再执行更新
})
.catch(err => console.error("Failed to connect to db...",err));

或者放到run函数中，确保连接就绪：

async function run() {
    await mongoose.connection.asPromise(); // 等待连接完成
    const courses = await getCourses();
    console.log("List of courses", courses);
    
    await updateCourse('5a68fdd7bee8ea64649c2777');
}
run();

2. 重复引入Mongoose的潜在问题 #

updateCourse函数内部重复引入了mongoose：

async function updateCourse(id) {
    const mongoose = require('mongoose'); // 重复引入
    // ...
}

虽然这不一定直接导致查询失败，但可能导致ObjectId的实例来自不同的Mongoose上下文，极端情况下可能影响ID有效性判断或查询匹配。

解决方案：
移除函数内部的重复引入，直接使用顶部已导入的Mongoose实例：

// 顶部已导入，函数内无需再引入
async function updateCourse(id) {
    console.log('checking..');
    if (!mongoose.Types.ObjectId.isValid(id)) {
        console.log('Invalid ID format');
        return;
    }
    // ...
}

3. 集合名称隐式映射不匹配（低概率） #

Mongoose默认会将Model名称（Course）转换为小写复数形式的集合名（courses）。如果数据库中的集合名称不是courses（比如是course），会导致查询不到数据。不过从getCourses能正常查询的结果来看，这个可能性较低，但可以验证。

解决方案：
定义Model时显式指定集合名称，避免隐式转换：

const Course = mongoose.model('Course', courseSchema, 'courses'); // 第三个参数指定集合名

验证修改后的流程 #

调整连接时机后，updateCourse会在数据库连接完成后执行，此时findById能正确匹配到对应ID的课程，完成更新操作。

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