对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

异常类别

MongoDB\Exception\BadMethodCallException

在对象上调用不受支持的方法时会引发此异常。

例如,将未确认的写关注(write concern)与MongoDB\Collection::insertMany()一起使用将返回MongoDB\InsertManyResult对象。调用MongoDB\InsertManyResult::getInsertedCount()是一个逻辑错误,因为插入的文档数量只能根据已确认写入操作的响应来确定。

该类扩展了 PHP 的 BadMethodCallException 类并实现了该库的 Exception 接口。


MongoDB\Exception\CreateEncryptedCollectionException

如果在创建数据键或创建collection时遇到任何错误,则由MongoDB\Database::createEncryptedCollection()抛出。原始异常和修改后的encryptedFields选项可以分别通过getPrevious()和getEncryptedFields()方法访问。

该类扩展了库的RuntimeException 类。


MongoDB\Exception\InvalidArgumentException

因与库中参数或选项解析相关的错误而抛出。

该类扩展了扩展的 InvalidArgumentException 类并实现了库的Exception 接口。


MongoDB\Exception\SearchNotSupportedException

当您尝试使用MongoDB搜索功能,同时连接到不支持这些功能的部署时,会引发此异常。

如果遇到此异常,请将MongoDB Server更新到支持MongoDB Search 的版本。要查看兼容性信息,请参阅Atlas文档中的MongoDB Search 兼容性和限制。

此类扩展了扩展的ServerException类。


MongoDB\Exception\UnexpectedValueException

当服务器的命令响应格式不正确或不符合库的预期时,会引发此异常。此异常表示抽象数据库命令的某些操作中的断言失败。这可能表明BSON响应已损坏,或者服务器或驱动程序中有错误。

该类扩展了扩展的 UnexpectedValueException 类,并实现了该库的 Exception 接口。


MongoDB\Exception\UnsupportedException

如果使用了某个选项但所选服务器不支持该选项,则会引发此异常。 如果默默地忽略不支持的选项可能会导致意外行为,则应谨慎使用。

该类扩展了库的RuntimeException 类。

注意

与 InvalidArgumentException 不同,在构造过程中解析操作的参数和选项时可能会抛出,而在执行操作之前,无法知道所选服务器。


MongoDB\GridFS\Exception\CorruptFileException

如果 GridFS 文件的元数据或数据段文档包含意外或无效数据,则会引发此异常。

选择 GridFS 文件时,如果元数据字段的类型不正确或其值超出范围(例如 负length )。 读取 GridFS 文件时,如果数据段的索引无序或其二进制数据的长度超出范围,则可能会抛出此错误。

该类扩展了库的RuntimeException 类。


MongoDB\GridFS\Exception\FileNotFoundException

如果没有找到符合选择条件的 GridFS 文件(例如 id 、 filename )。

该类扩展了库的RuntimeException 类。


MongoDB\Exception\Exception

此接口扩展了扩展的Exception接口,并由库中的所有异常类实现。


MongoDB\Exception\RuntimeException

该类扩展了扩展的RuntimeException类,而该扩展又扩展了 PHP 的RuntimeException类。