PHP连接MongoDB Atlas报错：返回值需为MongoDB\Driver\Server，却返回null

异常描述 #

Fatal error:  Uncaught TypeError: MongoDB\select_server(): Return value must be of type MongoDB\Driver\Server, null returned in C:\XXX\vendor\mongodb\mongodb\src\functions.php:535

Stack trace:
#0 C:\XXX\vendor\mongodb\mongodb\src\Database.php(273): MongoDB\select_server(Object(MongoDB\Driver\Manager), Array)
#1 C:\XXX\shared\connection.php(6): MongoDB\Database->createCollection('test')
#2 C:\XXX\index.php(11): require_once('C:\\XXX\\...')
#3 {main} thrown in C:\XXX\vendor\mongodb\mongodb\src\functions.php on line 535

环境与代码信息 #

• 已安装所有驱动并完成配置，PHP模块已启用
• 执行代码：

$client = new MongoDB\Client('mongodb+srv://XXXX/admin?authSource=YYYY&replicaSet=ZZZZ&readPreference=primary&ssl=true');
$collection = $client->CyberNightly;
$a = $collection->createCollection("test");

• composer.json配置：

{
    "require": {
        "mongodb/mongodb": "^1.13",
        "jenssegers/mongodb": "^v3.5.0",
        "ext-mongodb": "*"
    },
    "require-dev": {
        "roave/security-advisories": "dev-latest"
    }
}

• 使用MongoDB Atlas生成的对应驱动版本连接字符串（XXX、YYY、ZZZ为敏感信息掩码）

排查更新 #

深入排查库代码后发现：调用createCollection方法时，传入select_server函数的Manager对象为空，导致后续出错；观察库内创建该对象的逻辑时，参数传递均正确，但创建后的对象为空。

问题询问 #

我是否存在操作错误？该问题为何发生？

可能的原因与解决方向 #

1. 依赖版本冲突
   同时安装官方mongodb/mongodb库和第三方jenssegers/mongodb库，二者可能存在版本兼容问题。jenssegers/mongodb v3.5.x对应的官方驱动版本范围，大概率和你安装的mongodb/mongodb ^1.13不匹配，直接导致Manager对象初始化异常。建议先移除jenssegers/mongodb，单独用官方库测试连接是否正常。

2. 连接字符串与权限问题
   即便用了Atlas生成的连接字符串，也要确认几个关键点：

   • authSource是否正确？Atlas默认authSource是admin，如果你的用户是在其他数据库创建的，需对应修改
   • 检查Atlas控制台是否将当前服务器IP加入白名单，未授权IP会直接导致连接失败，进而引发Manager对象初始化异常
   • 确认连接字符串里的用户名、密码无误，特殊字符需做转义处理

3. PHP扩展与库版本不匹配
   ext-mongodb扩展版本必须和mongodb/mongodb库版本对应。比如mongodb/mongodb 1.13.x要求ext-mongodb至少1.14.0，你composer里写的ext-mongodb: "*"可能安装了不兼容的版本。可查官方文档确认版本对应关系，指定具体版本安装。

4. SSL配置问题
   Windows环境下，PHP若缺少SSL根证书，会无法建立SSL连接到Atlas。可下载官方CA证书，然后在php.ini里配置openssl.cafile = "证书路径"，或者在连接字符串里添加sslCAFile=/path/to/cert.pem参数。

5. 代码写法问题
   你用$client->CyberNightly这种动态属性获取数据库，虽PHP支持，但建议改用规范的$client->selectDatabase('CyberNightly')获取数据库对象，避免动态属性可能引发的隐式错误。

内容的提问来源于stack exchange，提问作者Simone De Luca