MongoDB连接字符串中密码含@或:必须URL编码，否则URI解析错乱导致认证失败；应使用quote_plus（Python）、encodeURIComponent（Node.js）等对密码严格编码，未编码将引发静默连接异常。
密码里有 @ 或 :，连接直接失败
MongoDB 连接字符串是标准 URI 格式，@ 和 : 是分隔符：用户名和密码之间用 :，密码和主机之间用 @。如果密码本身包含这两个字符，URI 解析器会误判结构，导致认证凭据被截断或错位。
- 例如密码为
pass@word:123，未编码时 URI 片段变成user:pass@word:123@host:port，解析器会把pass@word当作密码、123@host当作主机名，完全错乱 - 其他需编码的字符包括
/、?、#、[、]，它们在 URI 中都有保留语义 - URL 编码不是可选项——只要密码含这些字符，就必须编码，否则驱动不会报“密码错误”，而是报
authentication failed或更模糊的连接超时
Python（PyMongo）里怎么安全拼接连接串
别手写拼接，用 urllib.parse.quote_plus 或 quote 处理密码（推荐前者，它把空格也转成 +，兼容性更好）：
from urllib.parse import quote_plus
username = "myuser"
password = "pass@word:123"
database = "mydb"
encoded_password = quote_plus(password)
uri = f"mongodb://{'username'}:{encoded_password}@localhost:27017/{database}?authSource=admin"
-
quote_plus会把@→%40，:→%3A，/→%2F等 - 不要用
requests.utils.requote_uri或手动替换——它不保证全字符覆盖，且可能重复编码 - 如果用户名也有特殊字符（少见但可能），同样需要单独编码，不能只编密码
Node.js（MongoDB Driver / Mongoose）中容易忽略的点
Node.js 的 mongodb 驱动内部会自动对连接字符串做一次 decodeURIComponent，但前提是字符串本身是合法 URI。如果你手动拼接且没编码，驱动无法挽救。
- 错误写法：
mongodb://user:pass@word@localhost:27017/db—— 驱动收到的就是错乱字符串，后续 decode 无意义 - 正确做法：用
encodeURIComponent编码密码，再拼接：const uri = `mongodb://${user}:${encodeURIComponent(pass)}@localhost:27017/${db}?authSource=admin` - Mongoose 从 v7 起默认启用
autoEncrypt等新特性，若 URI 编码不规范，可能触发额外解析异常，表现不像认证失败，而是初始化卡住
Java（Spring Boot + MongoDB Driver）里的陷阱
Spring Boot 的 spring.data.mongodb.uri 配置项不经过 Java 的 URI 解码逻辑——它原样传给驱动。所以你填进去的必须是已编码的字符串。
- 错误示例：
spring.data.mongodb.uri=mongodb://admin:pa@ss:123@localhost:27017/test→ 启动就抛MalformedUriException或静默失败 - 正确做法：在配置文件里直接写编码后值，如
pa%40ss%3A123；或用application.yml的多行语法配合环境变量，由外部注入已编码密码 - 特别注意：
authentication-database参数（对应authSource）值本身不能含特殊字符，否则也要编码——虽然实践中几乎没人把数据库名起成my/db这种
真正难排查的，是那些看似连上了、也能执行简单命令，但在首次写操作时才崩的 case——往往就是密码部分被截断，导致认证上下文不完整。编码不是“以防万一”，是 URI 规范的硬性要求。
