Node.js借助Mongoose操作MongoDB已存JSON时返回异常且报OverwriteModelError错误

问题1：接口返回请求结构而非实际查询数据 #

根因是cidades.findOne({name: 'Rio Grande'})是返回Promise的异步方法，代码没有用await等待查询结果返回，此时cidade变量存储的是pending状态的Promise实例，序列化后自然只会展示Promise的内部结构，完全拿不到MongoDB返回的实际文档数据。原代码使用CircularJSON.stringify()的处理没有实际意义，因为没有拿到文档对象时序列化的是Promise实例，和循环引用问题无关。

问题2：重复请求触发OverwriteModelError报错 #

根因是Mongoose的模型属于全局单例，只要同名模型完成过一次编译注册，再次执行mongoose.model('模型名', schema)传入Schema参数时，就会抛出“无法覆盖已编译模型”的错误。原代码把模型注册的逻辑写在了接口处理函数内部，每次接口被请求都会重新执行一次模型注册，自然会反复触发这个报错，同时因为没有捕获这个异步抛出的错误，最终会触发未捕获的Promise拒绝警告。

修复操作要点 #

• 全局仅在应用初始化阶段实例化一次无固定结构的宽松Schema、完成一次模型注册，接口逻辑内直接复用已注册好的模型实例，不要在请求处理流程里重复创建Schema、重复调用带Schema参数的mongoose.model()方法。
• 给所有数据库异步查询接口补充await关键字，等待结果返回后再做响应处理，拿到实际文档后，只要文档不存在循环引用，可直接通过响应返回给前端，无需额外序列化处理。
• 所有异步流程补充try/catch错误捕获逻辑，避免未捕获的Promise拒绝警告。
• 动态场景下如果需要获取已存在的模型，可直接调用mongoose.model('municipios')，仅传模型名不传Schema参数，Mongoose会直接返回已编译的实例，不会触发覆盖报错。

修复后参考代码 #

// 应用启动阶段全局仅执行一次的初始化逻辑
const mongoose = require('mongoose');
const { Schema } = mongoose;

// 宽松Schema：不固定字段结构，适配无预定义结构的MongoDB集合数据
const looseSchema = new Schema({}, { strict: false });
// 仅完成一次模型注册，后续全局复用
const Municipios = mongoose.model('municipios', looseSchema);

app.get('/municipios', async (req, res) => {
  try {
    // 加await等待MongoDB查询完成，拿到实际文档数据
    const targetCity = await Municipios.findOne({ name: 'Rio Grande' });
    res.send(targetCity);
  } catch (err) {
    res.status(500).json({
      msg: '数据查询失败',
      errorDetail: err.message
    });
  }
});

内容的提问来源于stack exchange，提问作者Vinícius