用 MongoDB Kubernetes Operator 部署带认证的副本集最稳妥,但必须显式配置 auth 字段并提供合法 Secret,否则即使 Pod 运行正常、rs.status() 显示健康,也会因未加载认证模块导致“Authentication failed”——因 auth 是 CRD 中全有或全无的顶层结构体,不可省略或藏于其他配置中。

直接上结论:用 MongoDB Kubernetes Operator 部署带认证的副本集,比手写 StatefulSet + InitContainer + KeyFile 挂载要稳得多;但 Operator 默认不启用 auth,必须显式配置 auth 字段并提供密钥,否则集群跑起来是裸连状态,连 mongosh 都进不去。
为什么不能跳过 auth 配置块?
Operator 的 CRD(如 MongoDBCommunity)里,auth 是一个独立结构体,不是开关,而是「全有或全无」。漏掉它,哪怕你挂了 keyfile Secret、写了 --keyFile 参数,Operator 也会忽略——它只认自己解析后的 auth.key 和 auth.usersWanted。常见错误现象是:
Pod 全部 Running,rs.status() 显示健康,但 mongosh "mongodb://localhost:27017" --eval "db.runCommand({ping:1})" 直接报 not authorized
日志里反复出现 Authentication failed,但没提示缺凭据——因为根本没加载认证模块
-
auth必须作为顶层字段出现在 CR YAML 中,不能塞在additionalMongodConfig或processes.args2_6里 - Operator v1.34+ 要求
auth.key指向一个已存在的 Secret,且该 Secret 的key.txt键值必须是 6–1024 字节的随机 ASCII 字符(不能含换行) - 若用
auth.autoUser,Operator 会自动生成用户,但密码存在 Secret 里,得手动kubectl get secret解出来-o jsonpath='{.data.password}' | base64 -d
auth.usersWanted 怎么写才生效?
这个字段控制是否创建自定义用户,不是“建议创建”,而是“强制覆盖”。一旦设了,Operator 就会删掉所有非声明用户(包括内置 __system),所以必须显式包含集群内部通信所需的账号。典型写法:
auth:
key: mongodb-key
usersWanted:
- name: admin
db: admin
roles:
- role: root
db: admin
- name: __system
db: admin
roles:
- role: clusterAdmin
db: admin
- role: userAdminAnyDatabase
db: admin
注意:__system 用户必须存在,且角色不能少;否则副本集初始化时成员间握手失败,rs.status().members[n].stateStr 会长期卡在 STARTUP2
- 角色名大小写敏感,
clusterAdmin不是ClusterAdmin - 如果用
auth.autoUser: true,就别再写usersWanted,二者互斥 - Secret
mongodb-key必须提前创建,且命名空间要和 CR 一致(Operator 不跨 ns 查 Secret)
连接串里要不要加 authSource=admin?
要,而且必须加。Operator 部署的副本集默认启用 SCRAM-SHA-256 认证机制,且 admin 是唯一有效的 authSource(除非你显式改了 auth.authSource)。不加会触发静默降级到无认证模式,然后报错:
Authentication failed. Expected to find SCRAM-SHA-256 credentials for user 'admin' in database 'admin'
- 连接串格式必须是:
mongodb://admin:xxx@mongo-0.mongo-svc.default.svc.cluster.local:27017,mongo-1.mongo-svc.default.svc.cluster.local:27017,mongo-2.mongo-svc.default.svc.cluster.local:27017/?replicaSet=rs0&authSource=admin - Headless Service 名(如
mongo-svc)必须和 CR 中spec.service.name一致,Operator 不会自动推导 - 如果你用
externalAccess暴露服务,authSource仍为admin,不要改成$external——那是 TLS 客户端证书认证用的
Kubernetes 上 MongoDB 的 auth 不是“配完就通”的线性流程,而是一环扣一环的契约:Secret 存在 → CR 引用正确 → __system 用户权限完整 → 连接串指定 authSource。漏掉任意一环,表现都是“能连上但被拒”,排查时容易在日志里打转。











