1. 问题现象描述
在使用Python的pymongo库操作MongoDB时，开发者经常遇到get_database()方法意外返回None的情况。典型报错场景包括：
- 执行
db = client.get_database("mydb")后db对象为None - 后续操作抛出AttributeError异常
- 控制台无任何错误输出但数据无法写入
2. 根本原因分析
2.1 连接字符串认证失败
当使用MongoClient()初始化连接时，如果URI包含错误的认证信息，MongoDB服务端会返回AuthenticationFailed错误，但部分客户端版本可能静默处理导致get_database()返回None。
# 错误示例
client = MongoClient("mongodb://wrong_user:wrong_pwd@localhost")
2.2 数据库不存在时的静默行为
不同于SQL数据库，MongoDB的get_database()在数据库不存在时不会立即报错。某些驱动版本会返回None，而较新版本会返回空的数据库对象。
2.3 网络连接超时
TCP连接在connectTimeoutMS设置过短时，可能未完成握手就触发超时。使用以下代码验证连接状态：
print(client.server_info()) # 抛出OperationFailure则表示连接异常
3. 解决方案
3.1 显式连接验证
推荐在获取数据库对象前执行健康检查：
try:
client.admin.command('ping')
db = client.get_database("mydb")
except pymongo.errors.ConnectionFailure:
print("MongoDB连接失败")
3.2 使用字典式访问
作为替代方案，可以直接使用client["dbname"]语法，此方式在任何情况下都会返回数据库对象：
db = client["mydb"] # 等价于get_database但行为更明确
3.3 启用重试写入
在网络不稳定的环境中配置retryWrites参数：
client = MongoClient(
host,
retryWrites=True,
socketTimeoutMS=30000
)
4. 深度调试技巧
| 检测方法 | 预期结果 |
|---|---|
| client.list_database_names() | 返回现有数据库列表 |
| db.command("dbStats") | 获取数据库统计信息 |
5. 版本兼容性说明
不同pymongo版本存在行为差异：
- v3.12+：默认启用连接池
- v4.0+：改进错误消息格式
- v4.3+：引入get_database()的strict模式