使用ES2022 top-level await通过Mongoose连接MongoDB无连接就绪提示问题

首先明确：Mongoose完全支持ES2022的top-level await，你遇到的问题并非兼容性问题，大概率是代码配置或执行逻辑的细节疏漏。

常见原因及修复方法 #

1. 未配置项目为ES模块 #

top-level await仅在ES模块中生效，若你的项目默认是CommonJS模式，Node.js会静默忽略top-level await代码，不会执行也不会报错。

• 修复方式：
  • 在package.json中添加"type": "module"字段
  • 或者将入口文件后缀改为.mjs

2. 缺失错误捕获逻辑 #

top-level await如果遇到Promise拒绝（比如数据库连接失败），若没有try/catch捕获，Node.js会终止该Promise的执行且不输出任何错误，看起来就像连接代码没运行一样。

• 原来的async函数大概率包含try/catch，改用top-level await后补上即可：

import mongoose from 'mongoose';

try {
  await mongoose.connect('mongodb://localhost:27017/your-db-name');
  console.log('connection ready!');
} catch (err) {
  console.error('数据库连接失败:', err);
}

// 服务器启动代码
import express from 'express';
const app = express();
app.listen(3000, () => {
  console.log('服务器运行在3000端口');
});

3. 连接字符串或超时配置问题 #

如果MongoDB连接字符串有误（比如主机、端口、认证信息错误），连接请求会处于pending状态，不会触发成功回调也不会报错。

• 可以给连接添加超时配置，强制触发错误提示：

await mongoose.connect('mongodb://localhost:27017/your-db-name', {
  serverSelectionTimeoutMS: 5000 // 5秒超时后抛出错误
});

4. 连接事件监听顺序错误 #

若你依赖Mongoose的open事件打印提示，需确保事件监听在connect调用之前设置，否则可能错过事件触发：

• 错误写法：

await mongoose.connect('...');
mongoose.connection.on('open', () => console.log('connection ready!')); // 不会触发

• 正确写法：

mongoose.connection.on('open', () => console.log('connection ready!'));
await mongoose.connect('...');

或者更简单的方式：直接在await成功后打印提示，无需依赖事件监听。

总结 #

先确认项目已配置为ES模块，再给top-level await添加错误捕获，同时验证连接字符串和超时配置，基本就能解决问题。Mongoose对top-level await的支持没有问题，核心是确保代码符合ES模块规范，且有完善的错误处理逻辑。

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