MongoDB认证机制配置异常及SCRAM认证失败问题求助

一、启动失败（status=2/INVALIDARGUMENT）问题 #

原因 #

你的mongod.conf中security块存在YAML语法错误：

• keyFile:/st/mongodb/mongodb-keyfile行缺少冒号后的空格，YAML语法要求键值对的冒号后必须加空格才能被正确解析，这是导致启动参数无效的核心原因。
• 额外说明：若需保留authenticationMechanisms: SCRAM-SHA-1，需确保MongoDB版本为3.0及以上（该版本开始支持SCRAM-SHA-1），但语法错误是本次启动失败的直接诱因。

解决方案 #

修正mongod.conf的YAML格式，调整后配置如下：

security:
    authorization: enabled
    clusterAuthMode: keyFile
    keyFile: /st/mongodb/mongodb-keyfile
    authenticationMechanisms: SCRAM-SHA-1

修正后重启MongoDB服务即可正常启动。

二、认证失败（MechanismUnavailable）问题 #

原因 #

日志明确提示：用户Mtxader在数据库MtxDatabase中未注册SCRAM-SHA-256凭据，但客户端尝试使用该机制认证。

• 注释authenticationMechanisms: SCRAM-SHA-1后，MongoDB 4.0+版本会默认启用SCRAM-SHA-256和SCRAM-SHA-1两种认证机制，且优先使用SCRAM-SHA-256。
• 你的用户Mtxader是基于SCRAM-SHA-1创建的，仅存在该机制的哈希凭据，因此客户端用SCRAM-SHA-256认证时触发失败。

解决方案 #

提供两种可选方案：

方案1：强制MongoDB仅使用SCRAM-SHA-1认证

恢复mongod.conf中的authenticationMechanisms配置，指定仅启用SCRAM-SHA-1：

security:
    authorization: enabled
    clusterAuthMode: keyFile
    keyFile: /st/mongodb/mongodb-keyfile
    authenticationMechanisms: SCRAM-SHA-1

重启MongoDB后，客户端会自动适配使用SCRAM-SHA-1完成认证。

方案2：为用户生成SCRAM-SHA-256凭据

以管理员身份登录MongoDB，更新用户密码以生成对应凭据：

1. 管理员身份登录：

mongo -u 管理员用户名 -p 管理员密码 --authenticationDatabase admin

2. 切换到目标数据库：

use MtxDatabase

3. 更新用户密码（默认同时生成两种机制的凭据）：

db.updateUser("Mtxader", {pwd: "新密码"})

若需仅生成SCRAM-SHA-256凭据（MongoDB 4.0+支持），执行：

db.updateUser("Mtxader", {
  pwd: "新密码",
  mechanisms: ["SCRAM-SHA-256"]
})

操作完成后，客户端使用SCRAM-SHA-256认证即可成功。

内容的提问来源于stack exchange，提问作者prat_86