MongoDB URI格式无误却报InvalidURI错误求助

问题背景 #

原MongoDB URI格式合规且此前运行正常，未对URI做任何修改，但通过pip安装部分包后，出现InvalidURI错误。脱敏后的URI如下：

"mongodb+srv://user:password@cluster0.example.mongodb.net/?retryWrites=true&w=majority"

完整报错信息：

Traceback (most recent call last):
  File "D:\User\Work\Project\venv\lib\site-packages\pymongo\uri_parser.py", line 336, in split_options
    raise ValueError
ValueError

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "D:\User\Work\Project\venv\lib\site-packages\streamlit\runtime\scriptrunner\script_runner.py", line 565, in _run_script
    exec(code, module.__dict__)
  File "D:\User\Work\Project\app\pages\file.py", line 8, in <module>
    from utils.display_document import display_document
  File "D:\User\Work\Project\utils\display_document.py", line 12, in <module>
    mongodb = MongoDB(COLLECTION)
  File "D:\User\Work\Project\MongoDB.py", line 8, in __init__
    self.client = MongoClient(MONGODB_URI)
  File "D:\User\Work\Project\venv\lib\site-packages\pymongo\mongo_client.py", line 736, in __init__
    res = uri_parser.parse_uri(
  File "D:\User\Work\Project\venv\lib\site-packages\pymongo\uri_parser.py", line 511, in parse_uri
    options.update(split_options(opts, validate, warn, normalize))
  File "D:\User\Work\Project\venv\lib\site-packages\pymongo\uri_parser.py", line 338, in split_options
    raise InvalidURI("MongoDB URI options are key=value pairs.")
pymongo.errors.InvalidURI: MongoDB URI options are key=value pairs.

排查与解决步骤 #

1. 检查pymongo版本兼容性 #

pip安装新包时可能自动升级了pymongo，不同版本对URI解析规则存在差异：

• 执行pip show pymongo查看当前版本
• 若为较新版本（如>=4.0），确认URI参数retryWrites=true和w=majority是否符合规范（这两个参数本身是合法的，但部分版本升级后可能存在解析bug）
• 解决办法：
  • 回退到之前能正常运行的pymongo版本：pip install pymongo==<原版本号>
  • 或升级至最新稳定版：pip install --upgrade pymongo

2. 排查URI的转义与隐藏字符问题 #

• 确认代码中URI是否包含多余引号：你提供的URI外层有双引号，若代码中写成MONGODB_URI = "\"mongodb+srv://...\""，需去掉外层引号，改为MONGODB_URI = "mongodb+srv://user:password@cluster0.example.mongodb.net/?retryWrites=true&w=majority"
• 检查是否存在不可见特殊字符（如全角符号、空格），可将URI复制到纯文本编辑器（如Notepad++）查看

3. 定位包依赖冲突 #

新安装的包可能依赖不同版本的pymongo或URI解析相关库，导致版本冲突：

• 执行pip freeze对比安装前后的包版本差异，找出可能引发冲突的包
• 创建全新虚拟环境，仅安装必要依赖，逐步添加新安装的包，定位冲突源

4. 绕过URI参数解析测试 #

尝试将URI中的参数单独通过MongoClient的参数传递，验证是否为URI解析问题：

from pymongo import MongoClient

client = MongoClient(
    "mongodb+srv://user:password@cluster0.example.mongodb.net/",
    retryWrites=True,
    w="majority"
)

内容的提问来源于stack exchange，提问作者Sachin K Rao