使用MongoMemoryServer测试时Mongoose findOne返回null但文档已插入

以下是几种常见的原因及对应的解决方法：

1. 模型与集合名称不匹配 #

Mongoose 默认会将模型名转换为小写复数形式作为集合名称（比如User模型对应users集合）。如果你的注册接口直接通过原生MongoDB方法或其他工具将数据插入到了非默认名称的集合（比如单数user），那么Mongoose的User.findOne会去查询默认的users集合，自然无法找到文档。

解决方法：

• 定义模型时显式指定集合名称，与实际插入的集合名保持一致：

  const userSchema = new mongoose.Schema(
    { /* 字段定义 */ },
    { collection: 'user' } // 替换为实际使用的集合名
  );
  const User = mongoose.model('User', userSchema);
  

• 或者调整注册接口的插入逻辑，确保数据写入到Mongoose模型对应的默认集合中。

2. 查询条件的字段类型不匹配 #

如果插入的文档字段类型与Mongoose模型定义的类型不一致，会导致查询失败。比如：

• 插入的_id是字符串，但模型中定义为ObjectId，直接用字符串查询时Mongoose无法自动转换；
• 模型中email定义为String，但插入时误存为Number类型。

解决方法：

• 确保查询条件的类型与模型定义匹配，比如将字符串_id转换为ObjectId：

  const { Types } = require('mongoose');
  const foundUser = await User.findOne({ _id: new Types.ObjectId(userId) });
  

• 检查注册接口的插入逻辑，保证字段类型严格符合模型定义。

3. 数据库连接实例不统一 #

测试过程中如果MongoMemoryServer被重复创建，或者Express应用与测试代码连接的是不同的MongoDB实例，就会出现“集合有数据但查询不到”的情况——本质是两边操作的不是同一个数据库。

解决方法：

• 在测试全局初始化阶段创建唯一的MongoMemoryServer实例，统一传递连接URI给Express应用和测试代码：

  let mongoServer;
  beforeAll(async () => {
    mongoServer = await MongoMemoryServer.create();
    const mongoUri = mongoServer.getUri();
    // 连接Mongoose
    await mongoose.connect(mongoUri);
    // 将URI传给Express应用，确保应用使用同一个数据库
    process.env.MONGO_URI = mongoUri;
  });
  
  afterAll(async () => {
    await mongoose.disconnect();
    await mongoServer.stop();
  });
  

4. 异步操作未等待完成 #

注册接口中的数据库插入操作如果没有等待异步完成就返回响应，或者测试代码中查询操作在接口请求完成前执行，都会导致查询时文档还未被完全写入。

解决方法：

• 注册接口中确保插入操作使用await等待完成：

  // 注册接口示例
  app.post('/register', async (req, res) => {
    const userData = req.body;
    // 等待插入完成
    await User.create(userData);
    res.status(201).send('注册成功');
  });
  

• 测试代码中等待Supertest的请求完成后再执行查询：

  test('用户注册成功后可查询到', async () => {
    const userData = { email: 'test@example.com', password: '123456' };
    // 等待接口请求完成
    await request(app).post('/register').send(userData);
    // 执行查询
    const foundUser = await User.findOne({ email: userData.email });
    expect(foundUser).not.toBeNull();
  });
  

5. 模型strict选项导致字段不匹配 #

Mongoose默认开启strict: true，会过滤掉模型中未定义的字段。如果注册接口插入的文档字段名与模型定义不一致（比如模型用username，插入时用name），即使文档存在，用模型定义的字段作为查询条件也会返回null。

解决方法：

• 核对模型定义的字段名与注册接口插入的字段名完全一致，比如模型定义：

  const userSchema = new mongoose.Schema({
    email: { type: String, required: true },
    password: { type: String, required: true }
  });
  

  确保注册接口插入的是email和password字段，而非其他名称。

内容的提问来源于stack exchange，提问作者Jesús Roldán Cadena