问题现象与背景
当开发者使用pymongo连接MongoDB数据库时，经常遇到database_names()方法返回空列表或抛出权限不足异常的情况。这个经典问题通常发生在以下场景：
- 新安装的MongoDB实例首次连接
- 使用非管理员账户进行连接
- 启用了身份验证但未正确授权
- 网络防火墙限制访问
根本原因分析
通过分析MongoDB的访问控制机制和pymongo的源码实现，我们发现主要涉及四个关键因素：
- 用户角色缺失：连接账户缺少
listDatabases权限 - 认证配置错误：未启用auth或配置错误
- 版本兼容问题：pymongo与MongoDB版本不匹配
- 网络隔离策略：防火墙阻止了27017端口访问
解决方案与代码示例
方案1：验证管理员权限
from pymongo import MongoClient
# 使用管理员账户连接
client = MongoClient(
host="mongodb://admin:password@localhost:27017/",
authSource="admin"
)
# 检查数据库列表
print(client.list_database_names()) # 推荐使用新API
方案2：授予listDatabases权限
在MongoDB shell中执行：
db.grantRolesToUser("your_user", [
{ role: "read", db: "admin" },
{ role: "listDatabases", db: "admin" }
])
方案3：检查认证配置
确认mongod.conf包含：
security:
authorization: enabled
深度技术解析
MongoDB的访问控制模型基于角色授权机制。listDatabases是集群级别操作，需要以下任一条件：
| 角色 | 权限范围 |
|---|---|
| root | 超级用户权限 |
| dbAdminAnyDatabase | 所有数据库管理权限 |
最佳实践建议
- 使用
list_database_names()替代弃用的database_names() - 生产环境始终配置TLS加密连接
- 遵循最小权限原则分配角色
- 定期审计用户权限