MongoDB原生命令必须通过admin数据库调用，使用client.admin.command({"command": 1})传入字典参数，注意类型严格匹配，并捕获OperationFailure异常处理错误。
command 方法必须通过 admin 数据库调用
绝大多数 MongoDB 原生命令（如 listDatabases、getCmdLineOpts、serverStatus）只能在 admin 数据库上下文中执行，直接在业务数据库上调用会报 CommandNotFound 或权限错误。这不是 PyMongo 的限制，而是 MongoDB 服务端强制要求。
实操建议：
- 始终用
client.admin.command(...)，而不是db.command(...)（除非明确文档说明该命令支持非 admin 库，比如某些集合级命令如collStats） - 若使用副本集或分片集群，
admin是唯一能保证命令被路由到主节点并正确响应的入口 - 连接字符串中无需显式指定
?authSource=admin，但认证用户必须拥有clusterAdmin或对应命令所需的最小角色（如hostManager才能运行getCmdLineOpts）
传参格式必须是字典，不能是 JSON 字符串或关键字参数
command() 方法只接受一个位置参数：一个 dict，代表命令文档。传入 JSON 字符串、关键字展开（**{...}）、或者嵌套结构不合法的字典都会导致 TypeError 或服务端返回 InvalidNamespace 类错误。
常见错误示例：
立即学习“Python免费学习笔记（深入）”；
# ❌ 错误：传了字符串
client.admin.command('{"listDatabases": 1}')
<h1>❌ 错误：用了关键字参数（PyMongo 不支持这种语法糖）</h1><p>client.admin.command(listDatabases=1)</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill11526" title="Python Hardener"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="Python Hardener" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill11526" title="Python Hardener">Python Hardener</a>
<p>通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。</p>
</div>
<a href="/xiazai/skill11526" title="Python Hardener" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>✅ 正确：纯字典，键名严格匹配命令名（区分大小写）</h1><p>client.admin.command({"listDatabases": 1})</p><h1>✅ 正确：带选项的命令（注意 key 是字符串，不是变量名）</h1><p>client.admin.command({"serverStatus": 1, "recordStats": 0})
部分命令需显式指定参数类型，尤其是布尔和整数
MongoDB 命令对参数类型敏感。例如 listDatabases 的 nameOnly 必须是 bool，而 serverStatus 的 recordStats 必须是 int（不是 True/False）。Python 的 True 虽然可序列化为 BSON true，但某些命令逻辑会因类型不匹配静默忽略字段。
安全做法：
- 查官方文档确认每个字段的期望类型（例如 listDatabases 明确写
nameOnly: <boolean></boolean>） - 显式转换：用
bool(val)、int(val)，避免依赖 Python 默认行为 - 避免用
1代替True（虽然 BSON 中都转成 true，但部分命令校验逻辑会失败）
错误处理要捕获 OperationFailure，而非通用异常
命令失败时，PyMongo 抛出的是 pymongo.errors.OperationFailure，它携带了 code 和 errmsg 字段，比 Exception 更具诊断价值。直接 except Exception: 会掩盖权限、语法、超时等关键差异。
推荐写法：
from pymongo.errors import OperationFailure
<p>try:
result = client.admin.command({"listDatabases": 1, "nameOnly": True})
print(result["databases"])
except OperationFailure as e:
if e.code == 13: # Unauthorized
print("权限不足，请检查用户角色")
elif e.code == 89: # CommandNotFound
print("命令名拼写错误或 MongoDB 版本不支持")
else:
print(f"命令执行失败: {e.code} - {e.errmsg}")
真正容易被忽略的是：很多命令（如 setParameter）在生产环境默认禁用，即使有权限也会报错，必须在启动时加 --setParameter enableLocalhostAuthBypass=0 或配置文件中显式开启——这和 PyMongo 无关，但调试时最容易卡在这里。
