使用PHP MongoDB驱动动态创建数据库时遇授权错误的排查

核心错误点 #

1. 初始用户权限不足：你创建的test_mongodbu用户仅拥有test_mongodb库的dbOwner角色，这个角色只能管理当前库，没有跨库授予角色的权限，所以grantRolesToUser命令实际执行失败。
2. 会话权限未刷新：即便权限授予成功，当前已建立的MongoDB连接会话不会自动刷新权限，后续插入操作依然会用旧权限校验，导致无权限操作新库。

修复步骤 #

1. 重新创建具备全局用户管理权限的用户 #

先删除原有用户，在admin库下创建拥有跨库管理权限的用户（全局权限必须在admin库创建）：

# 删除旧用户
use test_mongodb
db.dropUser("test_mongodbu")

# 在admin库创建新用户
use admin
db.createUser({
  user: "test_mongodbu",
  pwd: "test_password",
  roles: [
    { role: "userAdminAnyDatabase", db: "admin" }, # 允许管理所有数据库的用户权限
    { role: "dbOwner", db: "test_mongodb" } # 保留原库的管理员权限
  ]
})

2. 修改Laravel代码逻辑 #

调整连接字符串的authSource为admin，执行授权后重新建立连接以刷新权限：

use MongoDB\Client as MongoClient;
use MongoDB\Driver\Manager as MongoManager;
use MongoDB\Driver\Command as MongoCommand;

$databaseName      = 'little_buds'; // 目标新数据库名
$collectionName    = 'test'; 
# 连接字符串指定authSource为admin，因为用户在admin库下
$connectionString  = sprintf(
    'mongodb://%s:%s@%s:%d/?authSource=admin',
    env('MONGODB_USERNAME'),
    env('MONGODB_PASSWORD'),
    env('MONGODB_HOST'),
    env('MONGODB_PORT')
);

// 1. 建立连接执行权限授予命令
$manager = new MongoManager($connectionString);
$grantCommand = [
    'grantRolesToUser' => env('MONGODB_USERNAME'),
    'roles' => [['role' => 'dbOwner', 'db' => $databaseName]]
];
// 授权命令必须在admin库执行
$manager->executeCommand('admin', new MongoCommand($grantCommand));

// 2. 重新建立连接，获取更新后的权限
$client = new MongoClient($connectionString);
$database = $client->$databaseName;
// 插入数据验证
$database->$collectionName->insertOne(['key' => 'value']);

3. 验证权限 #

执行代码后，可在MongoShell检查用户权限：

use little_buds
db.runCommand({usersInfo: "test_mongodbu", showPrivileges: true})

返回结果中如果包含little_buds库的dbOwner权限，则说明配置成功。

额外说明 #

• 不要用dbOwner角色做跨库权限操作，它仅针对单个数据库有效。
• MongoDB的权限是会话级别的，权限变更后必须重新连接才能生效，这是很多开发者容易忽略的点。

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