Node.js+Express对接MongoDB开发注册接口持续触发500错误排查

按触发优先级排列的错误点 #

• 核心触发原因：数据库实例取值错误
  在dbClient.js中，你将client.db（这是MongoClient实例上的一个方法，而非已连接的数据库操作对象）直接赋值给了_dbClient：

  // 错误代码
  _dbClient = client.db;
  

  后续在控制器中调用db.collection('users')时，本质是给一个普通函数添加.collection属性，直接抛出类型错误，被catch块捕获，这就是注册请求始终进入第一个catch分支的根本原因。
  你之前看到的MongoDB连接成功提示，仅代表客户端和MongoDB服务端的TCP链路打通，不代表你获取到了可操作指定数据库的实例。修正方式：必须调用db方法并传入数据库名，才能拿到可用的数据库实例：

  // 正确写法
  _dbClient = client.db('你的数据库名称，需和连接URI中指定的库名保持一致');
  

• catch块完全吞掉了真实报错
  所有catch分支都直接自定义了错误提示，完全没有把捕获到的原始错误打印到控制台，导致你看不到根因，只能看到自己写的模糊提示。临时调试时可以先将原始错误打印出来：

  catch(err) {
    console.log('真实报错原因:', err);
    const error = new HttpError('Signing in 1 failed, please retry later', 500)
    return next(error);
  }
  

• loginHandler存在多处变量未定义问题

  1. 整个登录处理函数中，没有调用getDb()给db变量赋值，直接就调用db.collection('users')，会抛出ReferenceError: db is not defined
  2. JWT签名逻辑中，两个接口都直接使用了user.id变量：登录分支里根本没有实例化User模型生成user对象，仅拿到了数据库返回的原始用户文档userExists，哪怕前置逻辑全部跑通，到JWT生成环节依然会报变量未定义的错误。

• 细节拼写错误

  • getDb()方法抛出的错误字符串拼错：'No databse found' 应为'No database found'
  • 登录失败的提示漏字：'Logging in failed, please again later' 缺少retry关键字

关于代码中两个await的疑问 #

• hashPassword一般基于bcrypt这类加密库实现，这类哈希计算是耗时的异步操作，返回Promise对象，必须加await才能拿到最终的哈希值，否则会直接把Promise对象存入数据库。
• user.save()是将数据写入MongoDB的异步IO操作，同样返回Promise，不加await会导致代码不等写入完成就继续执行，出现"接口返回成功但数据库未存到数据"的时序问题。

内容的提问来源于stack exchange，提问作者simón