maxIncomingConnections仅对mongos有效，必须通过setParameter注入，mongod不识别；控制mongod连接数应使用net.maxIncomingConnections或系统ulimit。

不能直接通过配置文件设置 maxIncomingConnections —— 这个参数只在 mongos 实例中有效，且必须用 setParameter 方式注入，mongod 不识别它。

为什么 maxIncomingConnections 在 mongod.conf 里写不生效

这个参数根本不在 mongod 的配置项白名单里。你把它加进 mongod.conf 的 setParameter: 下，启动时不会报错，但也不会起作用——mongod 忽略它。官方文档明确说明该参数仅适用于 mongos（分片集群的路由层），用于限制路由进程接收的客户端连接上限。

• mongod 实际靠操作系统级限制（如 ulimit -n）和网络层（如 net.maxIncomingConnections）控制连接数，但注意：net.maxIncomingConnections 是 mongod 的合法配置项，不是 maxIncomingConnections
• maxIncomingConnections 和 net.maxIncomingConnections 名字相近，但归属不同组件、语义不同，混用必踩坑
• 如果你在单机或副本集环境误配了 maxIncomingConnections，等于写了段“装饰性配置”

mongos 中正确启用 maxIncomingConnections

只有当你部署的是分片集群，且需要限制 mongos 路由节点的并发接入连接时，才用得上它。必须通过 setParameter 注入，不能放在顶层配置块。

mongodb-query

用于调试和故障排查，查询MongoDB数据库。用户需要时可以： (1) 列出所有数据库； (2) 列出数据库中的集合； (3) 执行MongoDB查询或命令。

下载

sharding:
  clusterRole: shardsvr
setParameter:
  maxIncomingConnections: 500

• 配置必须写在 mongos.conf（不是 mongod.conf）中
• 值必须是整数，建议留出余量（比如业务峰值连接数 × 1.2），避免路由层主动断连
• 修改后需重启 mongos 进程才能生效，热加载不支持
• 可通过 db.adminCommand({getParameter: 1, maxIncomingConnections: 1}) 验证是否已加载

真正影响 mongod 连接上限的配置项

如果你实际想控的是 mongod（数据节点）能接受多少连接，盯准这几个：

• net.maxIncomingConnections：直接限制 TCP 连接数，默认值 65536，设为 0 表示不限制（不推荐）
• systemLog.verbosity 和日志级别间接影响连接处理性能，高 verbosity 可能拖慢连接建立
• 操作系统层面的 ulimit -n 必须 ≥ net.maxIncomingConnections，否则 mongod 启动时会降级使用系统限制并打 warning 日志
• 连接池行为还受驱动配置影响（如 Node.js 的 maxPoolSize），服务端限制 ≠ 客户端实际建连数

别被名字带 “maxConnections” 的参数绕晕——先确认自己跑的是 mongod 还是 mongos，再查对应版本手册里该参数的 component 标注。一个字母拼错、一个层级放错，配置就成废纸。