直接修改 net.maxIncomingConnections 才有效，MongoDB 不支持用户级连接限制；该参数为服务端总连接上限，修改后需重启 mongod，且受系统 ulimit 限制。
直接改 maxIncomingConnections 才管用，其他参数都是障眼法
MongoDB 本身不支持按「用户」粒度限制连接数——它没有 user.maxConnections 这种配置。所谓“限制用户连接数”，实际只有两种可行路径：一是在服务端统一设硬上限，二是在客户端（应用层）靠连接池约束。前者由 maxIncomingConnections 控制，后者靠驱动里的 maxPoolSize。别被文档里零散出现的 maxConns（旧名）、setParameter.maxIncomingConnections 等写法绕晕，2026 年主流版本（6.0+ / 7.0）只认 net.maxIncomingConnections 这个位置。
-
maxIncomingConnections是服务器级总闸，设为 500 就意味着无论多少用户、多少 IP，加起来最多 500 个入站连接；超了直接拒连，日志里会报connection refused或too many connections - 它不是动态参数，改完必须重启
mongod，setParameter方式在配置文件里写无效（仅限运行时db.adminCommand({setParameter:1, maxIncomingConnections:500})，但不推荐） - 别漏掉系统层限制：如果
ulimit -n返回 1024，你配了 5000 也白搭——MongoDB 进程打不开那么多文件描述符，连接数卡死在 1000 左右是常见现象
配置文件怎么写才不踩坑
打开你的 /etc/mongod.conf，找到 net: 区块，在下面直接加一行，别塞进 setParameter: 里：
net: port: 27017 bindIp: 127.0.0.1,::1 maxIncomingConnections: 2000
- 值不是越大越好：4 核 8GB 的机器，设 2000 比设 10000 更稳妥；连接数翻倍不等于吞吐翻倍，反而可能因锁竞争、内存碎片导致
current高但active低 - 如果你用的是分片集群，
mongos节点也要单独配自己的maxIncomingConnections，它和mongod互不影响 - 改完必须执行
sudo systemctl restart mongod，光 reload 不生效；验证是否生效，连上去跑：db.serverStatus().connections，看available是否接近你设的值
客户端连接池才是你真正能控“用户级”并发的地方
假设你有 10 个微服务都连同一个 MongoDB 实例，每个服务自己开 100 个连接池，那总连接轻松破千。这时服务端限 2000 只是兜底，真正该调的是每个服务的驱动配置：
const client = new MongoClient(uri, {
maxPoolSize: 20, // 关键！别用默认 100
minPoolSize: 5,
socketTimeoutMS: 30000
});-
maxPoolSize是每个客户端实例的连接上限，不是全局；Node.js 驱动默认 100，Java 驱动默认 100，Python 默认 100——全得手动压下来 - 别信“我只查不写，连少点没关系”：哪怕只读，连接空闲太久也会被防火墙或代理断开，驱动自动重连反而制造更多连接抖动
- 连接泄露比连接数高更危险：没
client.close()、没session.endSession()、Promise 没 catch 导致异常中断，都会让连接卡在available: 0状态下慢慢堆积
为什么连不上？先看这三处再怀疑配置
连接数到上限后，现象往往是“部分请求失败”，而不是全挂，排查顺序必须严格：
- 查 MongoDB 进程当前文件描述符限制：
cat /proc/$(pgrep mongod)/limits | grep "Max open files"—— 如果Soft是 1024，立刻去/etc/security/limits.conf加* soft nofile 65535和* hard nofile 65535，并确认 systemd service 文件里没硬编码LimitNOFILE=1024 - 查真实连接分布：
db.currentOp({secs_running: {$gt: 0}}).itcount()看有没有长事务占着连接；db.runCommand({connPoolStats: 1})看各 IP 的连接来源，常有测试脚本或监控探针偷偷狂连 - 确认没被云厂商拦截：阿里云 MongoDB 控制台里“连接数管理”页面能看到实时连接 IP 和数量，有些云服务会额外加一层连接数熔断（比如达到 90% 自动限流），这时改本地配置没用
最常被忽略的一点：MongoDB 的 maxIncomingConnections 限制的是 TCP 入站连接总数，包括 shell 连接、mongodump、监控 agent、甚至你本地 mongo 命令行——别只盯着应用服务，顺手关掉闲置的 shell 会话，有时候就省出 20 个连接。
