MongoDB驱动连接字符串是客户端与服务器建立连接的核心配置，它采用标准URI格式，将主机、端口、数据库以及认证信息集中在一个字符串中。看似简单的字符串，却决定了数据一致性、故障转移行为、连接池规模和网络超时策略。如果参数配置不当，即使MongoDB集群运行正常，应用也可能频繁报错或性能低下。
在开始逐项解析参数之前，先了解URI的基本结构。MongoDB连接字符串的通用格式为mongodb://[username:password@]host1[:port1][,...hostN][/database][?options]，其中方括号表示可选部分。例如一个典型的连接串如下：
String uri = "mongodb://admin:secret@node1:27017,node2:27017,node3:27017/mydb?replicaSet=rs0&w=majority&journal=true";
上面的示例包含了认证信息、三个节点、数据库名以及replicaSet、w、journal等参数。后续章节会逐步拆解这些参数的作用与适用场景。
一、连接字符串的标准格式与组成部分
标准的MongoDB连接字符串从mongodb://开始，后续依次是认证信息、主机列表、数据库和查询参数。主机列表支持多个地址，用逗号分隔，每个地址可以单独指定端口，默认端口是27017。如果主机列表中包含多个节点，驱动会将其视为一个复制集或分片集群的入口，并自动执行节点发现。
数据库名称在路径中紧跟主机列表之后，用于指定认证时使用的身份认证数据库。例如mongodb://localhost:27017/admin表示使用admin库作为认证源。如果没有该部分，驱动会默认使用admin库。对于很多应用，连接串中没有用户名密码时数据库部分可以省略，但为了配置清晰，还是建议明确写出。
查询参数以?开头，多个参数用&符号连接。参数的值需要遵循URI编码规范，例如密码中包含特殊字符时要进行百分号编码。驱动解析URI时，会将所有参数转换为对应的连接选项。不同驱动（如Java、Python、Node.js）对部分参数的支持程度可能略有差异，但核心参数都是通用的，理解这些通用语义有助于跨语言排查问题。
二、影响数据一致性的关键参数：w与journal
数据一致性是数据库选型时最关心的指标之一。MongoDB允许客户端通过write concern控制写操作需要等待的确认级别。w参数就是写关注的等级，默认值为1，表示主节点写入成功后即返回。若设置w=0，则驱动不等待任何确认，性能最高但可能丢数据。若设置为w=majority，则要求写入被复制到多数派节点后才返回，此时能承受少数节点故障而不丢失数据。
与w紧密相关的是journal参数，它控制写入是否需要先持久化到日志文件。journal=true表示写操作必须等待写入WAL日志后才确认，这可以防止进程崩溃后数据丢失。在生产环境，通常建议将w=majority与journal=true同时使用，以兼顾性能和数据安全。
下面是一个配置了高级写关注的连接串示例：
uri = "mongodb://app:pass@10.0.0.1:27017,10.0.0.2:27017/billing?w=majority&journal=true&wtimeoutMS=5000"
上面的wtimeoutMS指定了写关注超时时间，单位为毫秒。如果复制集中有节点长时间未响应，写操作也不会无限等待，而是抛出超时异常。合理设置超时时间对系统的容错性非常重要，同时还可以避免因为网络抖动导致请求长时间挂起。
三、性能与连接池参数
连接池是驱动与MongoDB服务器之间的重要抽象层。每次创建新连接都会产生TCP握手和认证开销，连接池通过复用连接大幅降低延迟。maxPoolSize定义了连接池最大连接数，默认值通常为100。如果应用并发很高，这个值可能需要调大；但也要注意服务器文件描述符限制，不能无限制增大。反之，如果连接数远超实际并发需求，会浪费服务器资源。
minPoolSize则是连接池中保底连接数，驱动会尽量保持至少有这么多空闲连接。对于延迟敏感的服务，预创建连接可以避免请求突然到来时的冷启动。此外，waitQueueTimeoutMS表示线程等待从连接池获取连接的毫秒数，如果连接池已满且等待超时，驱动会抛出异常，而不是无限阻塞。在流量突增场景中，这个参数能有效保护应用不被连接池耗尽拖垮。
网络超时参数同样不容忽视。connectTimeoutMS控制建立TCP连接和完成握手的超时，默认是10秒；socketTimeoutMS控制读写套接字的空闲超时，默认也是10秒。但对于慢查询或大数据传输，可能需要调大。例如批量导入大量数据时，如果单个操作超过10秒，就会出现误报超时，这时应适当增大socketTimeoutMS。
四、复制集与高可用参数
高可用是MongoDB复制集的核心能力。连接字符串中的replicaSet参数指定复制集的名称，驱动会从主节点获取复制集拓扑信息，并自动发现所有成员。如果省略该参数，驱动只会连接主机列表中的地址，故障转移无法自动执行。对于分片集群，应使用mongos地址作为入口，而不是直接连接某个独立复制集成员。
readPreference参数控制读操作的路由策略，可选值包括primary、primaryPreferred、secondary、secondaryPreferred、nearest。默认是primary，即所有读操作都发往主节点。如果希望分摊主节点压力，可以将读操作路由到从节点，例如设置readPreference=secondaryPreferred。但需要注意，从节点在复制中可能出现短暂滞后，读取到的数据可能不是最新，因此需要根据业务对一致性的要求权衡。
对于连接单一节点的场景，directConnection参数可以避免驱动执行发现机制。设置directConnection=true表示直连给定地址，不进行拓扑发现。在开发测试或连接代理服务器时非常有用。此外，当使用负载均衡器或私有网络地址时，这个参数还可以防止驱动误将返回的其他节点地址当作可连接地址。
五、生产环境配置建议
综合以上参数，生产环境的连接字符串应当根据业务场景仔细设计。对于核心金融类业务，建议使用w=majority和journal=true，保证数据不丢；对于读多写少的场景，可以开启从节点读并通过maxPoolSize控制连接规模；对于跨机房部署，可以设置readPreference=nearest降低读延迟。
还需要留意URI中的认证机制参数。authSource用于指定认证数据库，authMechanism用于指定SCRAM-SHA-256或LDAP等认证方式。例如连接字符串中写入authSource=admin和authMechanism=SCRAM-SHA-256，让驱动使用正确的凭据进行认证。这些参数虽然不显眼，但配置错误会导致连接失败。
最后，强烈建议将连接字符串放在配置中心或环境变量中，避免硬编码。同时定期查看MongoDB官网的驱动文档，因为各版本驱动的参数可能发生调整。合理利用连接字符串参数，能让你的MongoDB应用稳定、高效地运行。