Navicat连接MongoDB提示权限不足

Question

使用Navicat连接MongoDB时提示“权限不足”，常见于未正确配置认证机制或连接用户权限过低。问题通常出现在启用身份验证的MongoDB实例中，若连接时未选择正确的认证数据库（如admin）、未启用SCRAM-SHA-1认证方式，或所用账号不具备相应数据库的读写权限，均会导致该错误。需确认用户名、密码及认证库匹配，并确保用户拥有目标数据库的适当角色权限。

Answer 1

一、问题现象与初步排查

在使用Navicat连接MongoDB时，提示“权限不足”是一个常见但影响较大的连接错误。该问题通常出现在已启用身份验证的MongoDB实例中，表现为客户端无法通过认证机制完成身份校验。

• 错误信息示例：Authentication failed due to insufficient privileges.
• 典型触发场景：远程连接部署在云服务器上的MongoDB服务。
• 初步判断方向：检查连接配置中的用户名、密码、认证数据库及认证方式是否正确。

二、认证机制基础：SCRAM-SHA-1 与认证数据库

MongoDB默认采用SCRAM-SHA-1作为用户身份验证机制，尤其在启用了security.authorization: enabled配置后。若Navicat未明确选择该认证方式，则可能导致握手失败。

关键点如下：

1. SCRAM-SHA-1是基于挑战-响应的安全认证协议，防止明文密码传输。
2. 用户必须在特定的“认证数据库”（authentication database）中进行身份验证，通常是admin库。
3. 例如，一个拥有readWrite角色的用户dev_user若创建于admin库，则其认证库也应为admin。

三、用户权限模型分析

MongoDB采用基于角色的访问控制（RBAC），每个用户被赋予一个或多个角色，角色决定了其对数据库的操作权限。

角色名称	适用数据库	权限说明
read	指定DB	仅可读取数据
readWrite	指定DB	读写操作权限
dbAdmin	指定DB	管理数据库结构
userAdmin	指定DB	管理用户和角色
root	admin	超级管理员，全实例权限

四、Navicat 连接配置详解

在Navicat中建立MongoDB连接时，需精确填写以下字段：

连接名: MongoDB_Prod
主机: 192.168.1.100
端口: 27017
认证数据库: admin
用户名: dev_user
密码: ********
认证方式: SCRAM-SHA-1
SSL: 否（根据实际情况启用）
    

特别注意：“认证数据库”字段不可忽略，即使目标操作数据库为myapp_db，只要用户是在admin中创建的，就必须将认证库设为admin。

五、诊断流程图：权限不足问题排查路径

graph TD
            A[连接失败: 权限不足] --> B{是否启用身份验证?}
            B -- 否 --> C[关闭auth并重试]
            B -- 是 --> D[检查认证数据库设置]
            D --> E{认证库是否正确?}
            E -- 否 --> F[更改为用户所属库, 如admin]
            E -- 是 --> G[检查认证方式]
            G --> H{是否为SCRAM-SHA-1?}
            H -- 否 --> I[切换至SCRAM-SHA-1]
            H -- 是 --> J[验证用户角色权限]
            J --> K{是否有目标DB读写权?}
            K -- 否 --> L[授予readWrite等角色]
            K -- 是 --> M[连接成功]

六、解决方案与最佳实践

解决“权限不足”问题的核心在于确保三个要素匹配：

• 用户名与密码正确无误
• 认证数据库与用户创建库一致
• 认证方式选择SCRAM-SHA-1

此外，建议执行以下MongoDB命令验证用户权限：

// 查看当前用户权限
use admin
db.runCommand({connectionStatus : 1})

// 检查特定用户的角色
db.getUser("dev_user", {showPrivileges: true})
    

若发现权限缺失，可通过以下命令授予权限：

// 授予用户对myapp_db的读写权限
use admin
db.grantRolesToUser(
  "dev_user",
  [{ role: "readWrite", db: "myapp_db" }]
)