Drupal8自定义模块带账号密码连接MongoDB失败问题咨询

不带账号密码可连通、带凭据连接失败，说明网络链路、端口、MongoDB基础服务状态正常，问题集中在认证参数配置、扩展兼容性、凭据有效性三个层面，按以下步骤排查修复：

1. 先验证凭据本身有效性 #

先在服务端用mongo shell直连验证账号密码正确性，排除账号本身的配置错误：

• 确认账号创建时所属的库：如果是全局管理账号，一般建在admin库下；如果是业务专用账号，通常建在对应业务库下，连接时authSource参数必须和账号所属库完全一致，填错会直接导致认证失败。
• 本地测试命令：

mongo "mongodb://user:password@serveraddress:27017/新闻feed存储业务库名?authSource=账号所属认证库"

如果shell能正常连通并执行查询，说明账号密码本身有效，问题出在PHP侧配置。

2. 修正PHP侧连接字符串 #

你之前的配置存在共性问题：未显式指定端口、未指定默认业务库、未匹配认证源、未兼容认证机制，正确的连接串格式如下：

// 替换对应参数即可
$this->connect_string = 'mongodb://urlencode(user):urlencode(password)@serveraddress:27017/新闻feed存储业务库名?authSource=账号所属认证库&authMechanism=SCRAM-SHA-1';

注意两个容易踩的坑：

• 如果账号密码里包含@、:、/、?这类特殊字符，必须对账号密码部分单独做urlencode编码，否则连接串解析时会把特殊字符识别成分隔符，导致地址、账号参数解析错误。
• PHP 7.4配套的MongoDB扩展如果版本低于1.6，不支持MongoDB 4.0+默认的SCRAM-SHA-256认证机制，这时候要么升级扩展到1.6以上版本，要么把账号的认证机制调整为SCRAM-SHA-1。

3. Drupal自定义模块的连接调试 #

不要依赖服务端日志排查问题，直接在模块里捕获PHP侧的连接异常，能直接定位错误原因：

try {
  $manager = new \MongoDB\Driver\Manager($this->connect_string);
  // 发起ping命令验证连接和鉴权状态
  $pingCmd = new \MongoDB\Driver\Command(['ping' => 1]);
  $manager->executeCommand('新闻feed存储业务库名', $pingCmd);
} catch (\MongoDB\Driver\Exception\ConnectionException $e) {
  // 打印异常信息，会明确返回是密码错误、authSource错误、认证机制不支持还是连接超时
  echo $e->getMessage();
}

额外注意：不要把连接串硬编码在模块逻辑里，推荐放在Drupal的settings.php配置文件中通过配置API读取，避免部署环境切换时的配置冲突。

4. 服务端日志排查补充 #

如果需要查服务端日志，先修改MongoDB配置文件mongod.conf，把systemLog.verbosity参数调整为2，重启服务后再尝试连接，日志会明确记录每一次认证失败的具体原因，不会出现无日志的情况。

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