PHP调用MongoDB insertOne()报方法未定义错误排查

• 核心错误为MongoDB对象获取逻辑不符合官方库设计：实例化自定义Database类时传入的参数是字符串"test->users"，类内部直接将该字符串作为MongoDB\Client实例的动态属性访问，等价于执行(new \MongoDB\Client)->{"test->users"}，该操作返回的是名称为test->users的数据库实例（类型为MongoDB\Database），而非test数据库下的users集合实例。
• insertOne()是MongoDB\Collection集合类的方法，MongoDB\Database数据库类未定义该方法，因此触发未定义方法的致命错误。
• 其他目录相同逻辑代码可正常运行，是因为对应代码没有将库名、集合名和PHP对象操作符->拼接为单个字符串传入，可正确获取到集合实例。

不要将PHP链式操作语法作为字符串内容传参，调整代码拆分库名、集合名的传参与获取逻辑，有两种可落地的修改方式：

1. 调整类结构与传参，分步获取集合实例
   修改自定义Database类代码，构造函数新增集合名参数：

<?php

namespace auth;
include_once dirname(__DIR__) . "/config.php";

class Database
{
    public function __construct(
        private readonly string $dbname,
        private readonly string $collectionName,
    ){
        $this->run();
    }

    private function run(): void
    {
        // 先获取数据库实例，再获取集合实例
        $collection = (new \MongoDB\Client)->{$this->dbname}->{$this->collectionName};

        $insertOneResult = $collection->insertOne([
            'username' => 'admin',
            'email' => 'admin@example.com',
            'name' => 'Admin User',
        ]);

        printf("Inserted %d document(s)\n", $insertOneResult->getInsertedCount());
        var_dump($insertOneResult->getInsertedId());
    }
}

同步修改test.php中的实例化代码，分开传入库名和集合名：

include_once "./assets/php/config.php";
// 第一个参数为库名test，第二个参数为集合名users
$database = new \auth\Database("test", "users");

2. 使用官方提供的显式方法选择集合（推荐，可读性更高，无动态属性歧义）
   将run方法中获取集合的逻辑替换为官方封装的selectCollection方法，逻辑更稳定：

private function run(): void
{
    $client = new \MongoDB\Client;
    // 显式传入库名、集合名获取集合实例
    $collection = $client->selectCollection($this->dbname, $this->collectionName);

    $insertOneResult = $collection->insertOne([
        'username' => 'admin',
        'email' => 'admin@example.com',
        'name' => 'Admin User',
    ]);

    printf("Inserted %d document(s)\n", $insertOneResult->getInsertedCount());
    var_dump($insertOneResult->getInsertedId());
}

修改完成后可在调用insertOne前打印$collection变量，确认其类型为MongoDB\Collection即可验证逻辑正确。

注意：PHP中字符串内的->不会被解析为对象操作符，只会被识别为普通字符，不要试图通过拼接字符串的方式实现链式对象访问。

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