MongoDB 最大连接数 maxIncomingConnections 如何调整

调整 MongoDB 最大连接数需区分实例类型：数据节点 mongod 应配置 net.maxIncomingConnections，路由节点 mongos 需通过 setParameter 注入 maxIncomingConnections。错误配置会导致参数被忽略，连接数限制不生效。

先说结论：区分实例类型是配置生效的前提，mongod 和 mongos 的参数位置不同，混用会导致配置无效。

命令速用版

根据实例类型选择对应的配置片段，写入配置文件后重启服务。

mongod 数据节点配置：

net:
  maxIncomingConnections: 500

mongos 路由节点配置：

setParameter:
  maxIncomingConnections: 500

命令行临时启动参数：

mongod `--maxIncomingConnections` 500

参数归属组件不同决定了配置位置差异。maxIncomingConnections 原生仅适用于 mongos 分片路由层，而 mongod 数据节点识别的是 net.maxIncomingConnections。

若在 mongod 配置文件中误写 setParameter.maxIncomingConnections，启动时不会报错但会被忽略，导致连接数限制未实际生效。官方文档明确说明该参数仅适用于 mongos，mongod 实际靠操作系统级限制和网络层配置控制连接数。

按以下步骤修改配置文件并重启服务，确保配置生效。

1. 确认实例类型：检查进程启动命令或配置文件，确认是 mongod 还是 mongos。

2. 编辑配置文件：打开/etc/mongod.conf 或/etc/mongos.conf，找到对应段落添加参数。

3. 检查系统限制：执行 ulimit -n 确保系统文件打开数限制大于配置的连接数，否则 mongod 会降级使用系统限制。

4. 重启服务：修改配置后需重启 MongoDB 进程，热加载不支持该参数修改。

通过 MongoDB shell 执行命令查看当前连接状态和参数值。

查看当前连接数：

db.serverStatus().connections

验证参数加载值（mongos）：

db.adminCommand({getParameter: 1, maxIncomingConnections: 1})

观察输出中的 current 和 available 数值，current 数值加 available 数值即为当前最大连接数。

配置名称相近但归属不同组件，混用必踩坑。maxIncomingConnections 和 net.maxIncomingConnections 名字相近，但前者针对 mongos，后者针对 mongod。

操作系统 ulimit 限制优先级更高。如果系统 ulimit -n 小于配置值，MongoDB 启动时会降级使用系统限制并打印 warning 日志。

客户端连接池影响实际建连数。服务端限制不等于客户端实际建连数，还需调整驱动配置如 Node.js 的 maxPoolSize。

默认值通常为 65536，设为 0 表示不限制，但不推荐在生产环境不设限制。

需要重启 MongoDB 进程才能生效，该参数不支持热加载。

超过限制时 MongoDB 会拒绝新连接并返回错误，日志中可能出现 connection refused because too many open connections。