如何连接名称包含特殊字符的MongoDB数据库？

这个问题我之前也帮人排查过，确实是MongoDB连接URI解析的一个坑——尤其是当数据库名称里包含?这种本身属于URI语法的特殊字符时，很容易出现解析错误。我给你几个靠谱的解决方案：

方案一：避开URI路径，单独指定数据库名称（最推荐） #

很多MongoDB驱动都支持先连接到实例，再通过API直接传入原始的数据库名称（不需要编码），这能完全避开URI解析对特殊字符的干扰。核心思路是：把认证参数authSource放在URI的查询参数里（这才是它的正确位置），而目标数据库名称单独指定。

举个Python的示例代码：

from pymongo import MongoClient

# 先连接MongoDB实例，URI中仅配置连接信息和认证源，不指定数据库
client = MongoClient("mongodb://your_username:your_password@host:port/?authSource=Admin")
# 直接传入原始的数据库名称，无需编码
target_db = client["database?authSource=Admin"]

# 测试是否能正常访问
print(target_db.list_collection_names())

其他语言的驱动逻辑类似，比如Java可以用MongoClient.getDatabase("database?authSource=Admin")，Node.js用client.db("database?authSource=Admin")——本质都是绕开URI的路径解析，直接通过API指定数据库名。

方案二：正确编码数据库名称，拆分URI各部分 #

如果一定要用URI方式连接，必须注意只编码数据库名称里的特殊字符，不能把认证参数也一起编码（这是你之前踩的坑）。

正确的URI结构应该是：

mongodb://your_username:your_password@host:port/database%3FauthSource%3DAdmin?authSource=Admin

• 路径部分的database%3FauthSource%3DAdmin是把原始数据库名称里的?编码为%3F、=编码为%3D后的结果；
• 查询参数里的authSource=Admin是独立的认证配置，和数据库名称无关。

不过这种方式依赖驱动对URI路径编码的解析一致性，不如方案一稳定。

额外提醒：区分数据库名称和认证参数 #

要注意，authSource是MongoDB的认证参数，用于指定认证时使用的数据库（通常是admin），它原本不应该成为目标数据库名称的一部分。你遇到的情况是软件的缺陷导致的错误命名，所以连接时一定要明确：

• 目标数据库名称是database?authSource=Admin（带特殊字符的完整字符串）
• 认证用的authSource还是Admin（或你实际的认证数据库）

内容的提问来源于stack exchange，提问作者Hugo ESQUIBET