本文详解如何使用 mgo 驱动（go 语言 mongodb 官方第三方驱动）在程序中调用等效于 mongo shell 中 `db.stats()`、`rs.status()` 和 `db.serverstatus()` 的管理命令，包括底层命令映射、正确数据库上下文（如 admin）、实际代码示例及注意事项。
在 MongoDB 的 Go 生态中，mgo（虽已归档但仍在广泛使用）提供了 Session.Run() 方法用于执行数据库命令（database commands），这正是替代 mongo shell 中各类“helper 函数”的核心机制。需要注意的是：db.stats()、rs.status() 和 db.serverStatus() 并非原生命令，而是 shell 封装的辅助函数（shell helpers）。它们背后实际调用的是标准的 MongoDB 命令，且多数需在 admin 数据库上下文中执行——这是权限与作用域的关键前提。
要准确调用这些命令，推荐两种定位真实命令的方式：
- 在 mongo shell 中执行 db.listCommands()，搜索关键词（如 "replSetGetStatus" 或 "dbStats"）；
- 直接输入 helper 名称不带括号（如 rs.status），Shell 会打印其源码，例如：
> rs.status function () { return db._adminCommand("replSetGetStatus"); }可见它本质是向 admin 库发送 replSetGetStatus 命令；同理，db.stats() 对应 dbStats 命令（注意命名差异：dbstats 是旧版别名，推荐用 dbStats），而 db.serverStatus() 则直接对应 serverStatus 命令。
以下是可运行的完整示例（基于 mgo.v2）：
package main
import (
"fmt"
"gopkg.in/mgo.v2"
"gopkg.in/mgo.v2/bson"
)
func main() {
// 连接 MongoDB（若启用认证，请在 URI 中添加 credentials，如 "mongodb://user:pass@localhost:27017"）
session, err := mgo.Dial("localhost:27017")
if err != nil {
panic(err)
}
defer session.Close()
// 推荐设置为 Monotonic 模式以平衡一致性与性能
session.SetMode(mgo.Monotonic, true)
var result bson.M
// ✅ serverStatus：必须在 admin 数据库执行
if err := session.DB("admin").Run(bson.D{{"serverStatus", 1}}, &result); err != nil {
panic(fmt.Sprintf("serverStatus failed: %v", err))
}
fmt.Println("serverStatus:", result["host"], result["uptime"])
// ✅ dbStats：可在目标数据库（如 test）执行，返回该库统计信息
if err := session.DB("test").Run(bson.D{{"dbStats", 1}}, &result); err != nil {
panic(fmt.Sprintf("dbStats failed: %v", err))
}
fmt.Println("test dbStats:", result["collections"], result["objects"])
// ✅ replSetGetStatus：必须在 admin 数据库执行（仅副本集有效）
if err := session.DB("admin").Run(bson.D{{"replSetGetStatus", 1}}, &result); err != nil {
panic(fmt.Sprintf("replSetGetStatus failed: %v", err))
}
fmt.Println("replSet status:", result["set"], result["myState"])
}⚠️ 关键注意事项：
- 所有管理命令（尤其是 replSetGetStatus 和 serverStatus）必须在 admin 数据库上调用，否则将返回权限错误或空响应；
- 若 MongoDB 启用了访问控制（--auth），连接 URI 必须包含具有 clusterAdmin（或至少 hostManager + clusterMonitor）角色的用户凭证；
- dbStats 命令作用于指定数据库（如 "test"），而非 admin；
- 使用 bson.D（有序文档）比字符串更安全、更符合官方推荐，避免字段顺序引发的兼容性问题；
- mgo 已停止维护（官方推荐迁移至 mongo-go-driver），新项目请优先采用官方驱动，其命令调用方式为 client.Database("admin").RunCommand(ctx, bson.D{{"serverStatus", 1}})。
掌握这些命令映射与上下文规则，即可在 Go 应用中稳健实现 MongoDB 运维监控、状态采集与自动化诊断能力。
