PHP获取MongoDB集合迭代器时报身份验证错误及Traversable丢失问题

认证失败问题排查 #

你遇到的认证报错本质是MongoDB连接的身份校验不通过，可按以下顺序排查：

• 检查连接字符串$db_string里的用户名、密码是否正确，若密码包含@、:、/等URL特殊字符，必须先做URL编码再写入连接字符串，避免特殊字符被当成连接配置的分隔符导致解析错误。
• 确认账号的认证源配置：如果你的MongoDB账号是在admin库下创建的，需要在连接字符串末尾追加参数authSource=admin，否则默认会用你要操作的业务库作为认证源，无法匹配到对应账号。
• 确认你使用的账号拥有database_name库的读权限，权限不足也会触发认证失败类报错。

迭代器丢失Traversable属性问题排查 #

该问题的核心原因通常有以下三类：

1. MongoDB的find()方法返回的是MongoDB\Driver\Cursor类实例，它本身实现了Traversable接口，但属于仅支持单次单向遍历的游标对象，一旦被遍历过一次底层游标就会耗尽失效。你提到的SourcePluginBase是Drupal迁移体系的基类，它的getIterator()方法如果检测到游标已经耗尽，会默认返回空数组等非Traversable类型的值，就会出现你遇到的检测不通过的情况。
2. 若你的类实现了序列化相关接口，$this->iterator属性如果被序列化后再反序列化，MongoDB\Driver\Cursor对象的底层游标资源会丢失，反序列化后的实例不再是有效Traversable对象。
3. 排查initializeIterator和doCount方法的执行间隙，是否有其他逻辑修改了$this->iterator属性的值，将其赋值为了数组、null等非Traversable类型。你可以在doCount中输出$iterator的实际类型，即可快速定位问题。

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