PyMongo 报错 InvalidURI: MongoDB URI options are key=value pairs 通常并非 URI 结构错误，而是密码或用户名中含特殊字符（如 @, /, :, ?, #, [, ]）未做 URL 编码所致，尤其在使用 mongodb+srv:// 协议时更易触发解析异常。
pymongo 报错 `invaliduri: mongodb uri options are key=value pairs` 通常并非 uri 结构错误，而是密码或用户名中含特殊字符（如 `@`, `/`, `:`, `?`, `#`, `[`, `]`）未做 url 编码所致，尤其在使用 `mongodb+srv://` 协议时更易触发解析异常。
该错误表面提示“URI 选项应为 key=value 形式”，实则是 PyMongo 在解析连接字符串时，因未编码的特殊字符导致 URI 分割逻辑崩溃——例如密码中包含 @ 或 /，会使解析器误将后续部分识别为新的主机名或路径，从而破坏整个 URI 的语法结构。
以你提供的 URI 为例：
"mongodb+srv://user:password@host/?retryWrites=true&w=majority"
若实际密码为 fhsadf@6416 或 my/p@ss!word，其中的 @ 和 / 会直接打断 user:password@host 的标准格式，使解析器在 split_options() 阶段抛出 ValueError，最终被包装为 InvalidURI 异常。
✅ 正确做法：对用户名和密码进行严格的 URL 编码（Percent-encoding）
PyMongo 要求所有 URI 中的敏感字符必须符合 RFC 3986 规范。Python 标准库 urllib.parse.quote_plus 或 quote 可安全完成此任务：
from urllib.parse import quote
username = "my_user"
password = "fhsadf@6416" # 含 @ —— 必须编码
encoded_username = quote(username, safe='')
encoded_password = quote(password, safe='')
uri = f"mongodb+srv://{encoded_username}:{encoded_password}@cluster0.xxx.mongodb.net/?retryWrites=true&w=majority"
? 注意：quote(..., safe='') 确保 /, @, : 等全部编码（默认 safe='/' 会保留斜杠，但密码中 / 也需编码）；若用户名/密码含中文或 Unicode 字符，同样必须编码。
⚠️ 其他关键排查点（即使编码正确仍需验证）：
- 协议一致性：mongodb+srv:// 仅适用于 MongoDB Atlas 或启用 DNS SRV 记录的集群；若连接本地或自建副本集，请改用 mongodb:// 并显式指定主机+端口（如 mongodb://localhost:27017）。
-
认证数据库（authSource）缺失：当用户在 admin 数据库创建时，必须显式指定 ?authSource=admin，否则 PyMongo 默认尝试在目标数据库（如 testDatabase）中认证，导致失败：
mongodb+srv://user:pass@cluster0.xxx.mongodb.net/mydb?authSource=admin&retryWrites=true&w=majority
- 过时驱动兼容性：PyMongo ≥ 4.0 已完全弃用 useNewUrlParser / useUnifiedTopology 等旧选项；若代码中仍传入这些参数（哪怕值为 True），虽通常静默忽略，但在某些版本组合下可能干扰解析逻辑——请彻底移除。
? 快速诊断脚本（运行前替换你的凭据）：
from urllib.parse import quote
from pymongo import MongoClient
raw_user, raw_pass = "my_user", "p@ss/w0rd"
uri = f"mongodb+srv://{quote(raw_user)}:{quote(raw_pass)}@your-cluster.mongodb.net/test?authSource=admin"
try:
client = MongoClient(uri, serverSelectionTimeoutMS=5000)
client.admin.command('ping') # 主动触发连接与认证
print("✅ 连接成功")
except Exception as e:
print(f"❌ 连接失败: {type(e).__name__}: {e}")
? 总结：InvalidURI: MongoDB URI options are key=value pairs 是典型的“假报错、真编码”问题。90% 以上案例均由未编码的特殊字符引发。务必对所有动态拼接的用户名/密码调用 urllib.parse.quote()，并确保 URI 协议、认证源、DNS 可达性三者匹配。切勿依赖“之前能用”——pip 安装新包可能升级 PyMongo 至更严格解析版本（如 4.5+），从而暴露原有 URI 的隐性缺陷。
