mongoclient 连接池默认启用，无需手动配置；只要全局单例初始化并调用 connect()，连接即被自动复用，错误在于每次请求新建实例或过早 close()。
MongoClient 连接池默认就开了，不用手动配置
Node.js 用 mongodb 官方驱动时，MongoClient 实例本身就是一个连接池管理者——只要你不调用 client.close()，它就会复用底层连接。很多人误以为要显式开启或设置连接池参数才“算用了池”，其实只要用 new MongoClient(uri) + client.connect()，池就已启用。
常见错误是每次插入都新建 MongoClient 实例，比如写在路由处理函数里：
// ❌ 错误：每次请求都新建 client，连接数爆炸
app.post('/user', async (req, res) => {
const client = new MongoClient(uri);
await client.connect(); // 每次都新建连接，不复用
await client.db().collection('users').insertOne(req.body);
await client.close(); // 关闭后下次还得重连
});
正确做法是全局单例初始化一次，在应用启动时完成连接：
- 在模块顶层创建并连接
client，导出复用 - 确保只调用一次
client.connect()，且不在每次操作后close() - 连接失败需监听
error事件或用try/catch，否则进程可能静默挂掉
insertOne 和 insertMany 的行为差异直接影响错误处理逻辑
insertOne 插入单条，失败时抛出异常（如重复键、类型不匹配），返回带 insertedId 的结果对象；insertMany 默认遇到错误就中断，不继续插后续文档，除非传 {ordered: false}。
例如向有唯一索引的 email 字段插入重复值：
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
// ✅ 带 ordered: false 可跳过冲突项，继续插其余
await collection.insertMany([
{ email: 'a@b.com' },
{ email: 'a@b.com' }, // 冲突
{ email: 'c@d.com' }
], { ordered: false });
// ❌ 不加参数时，第二条失败，第三条不会插入
await collection.insertMany([...]);
-
insertOne失败 = 整个操作失败，适合强一致性场景 -
insertMany加{ordered: false}会返回result.insertedCount和result.insertedIds，但冲突项不计入insertedCount - 注意：即使
ordered: false，批量中某条因 schema 校验失败（如 required 字段缺失）仍会报错中断，不是所有错误都被忽略
连接字符串里的 ?retryWrites=false 是为了绕过分片集群的写关注限制
本地开发或单节点 MongoDB 通常不需要改这个参数，但如果你连的是 Atlas 免费层或某些托管服务，可能会遇到 WriteConcernError 或插入后查不到数据——根源常是默认的 retryWrites=true 在无仲裁节点环境下不兼容。
解决方法是在连接 URI 后追加查询参数：
mongodb+srv://user:pass@cluster.mongodb.net/db?retryWrites=false
- 仅当明确看到错误信息含
retryWrites或write concern时才加 - 加了之后，写操作不再自动重试，网络抖动可能导致单次写失败，需业务层捕获
MongoServerError并重试 - 生产环境建议保留
retryWrites=true，并确保 MongoDB 版本 ≥ 4.2、副本集配置正确
用 try/finally 确保连接不泄漏比用 .close() 更关键
很多人以为“连接完记得 close 就行”，但在 Node.js 长生命周期服务中，client.close() 应该只在进程退出前调用（如监听 SIGINT）。日常操作中，真正危险的是没 catch 异常导致连接卡住或未释放。
推荐结构：
let client;
async function initDB() {
client = new MongoClient(uri);
await client.connect();
}
// 进程退出时关闭
process.on('SIGINT', async () => {
await client?.close();
process.exit(0);
});
- 不要在每个数据库操作后
client.close()，这会让后续请求拿不到连接 - 所有
collection.insertXxx()调用必须包裹try/catch，捕获MongoServerError、MongoNetworkError等子类，而不是泛 catchError - 如果使用 Express，可在中间件里检查
client.topology?.state !== 'connected'，触发重连逻辑（但更推荐重启进程）
连接池本身很健壮，真正容易被忽略的是异常路径下未释放 cursor 或未处理 connection loss 导致的内存缓慢增长——这不是代码写错，而是没把数据库当外部不可靠依赖来对待。
