操作错误处理

概述

本页介绍了在使用 MongoDB Rust 驱动执行 MongoDB 操作时可能遇到的错误。一旦您了解了驱动器引发的操作错误类型，您就可以采取适当的措施来处理它们或修正导致错误的代码。

错误类型

如果驱动程序在执行操作时遇到错误，它将返回一个错误类型。

的Error类型包含一个描述发生错误类型的kind字段。该kind字段的值为枚举ErrorKind。该ErrorKind枚举有不同的错误类型变体，包括以下几种

• InvalidArgument：向方法提供了一个无效的参数

• Authentication：驱动程序在身份验证过程中遇到了错误

• ServerSelection：客户端无法选择操作的服务器

• Write：在写入操作期间发生错误

• Transaction：在事务期间发生错误

例如，如果您尝试执行一个插入操作，该操作重复了集合中已存在的一个_id字段值，驱动程序将返回一个Error实例并打印以下错误消息

Error: Error { kind: Write(WriteError(WriteError { code: 11000,
code_name: None, message: "E11000 duplicate key error collection:
db.test_coll index: _id_ dup key: { _id: 1 }", details: None })), labels:
{}, wire_version: None, source: None }

在前面的错误消息中，kind字段的值为Write。有关此类错误的更多信息，请参阅本指南中的写入错误类型部分。

连接错误

并发操作错误可能会清除连接池，中断您的服务器连接。在这种情况下，驱动程序会在Error类型中引发错误，其中kind字段的值为ConnectionPoolCleared。错误消息描述了并发操作失败的原因。

有关如何调整您的连接池以解决此错误的信息，请参阅服务器手册中的调整连接池设置。

根据产生错误的环境，驱动程序可能会在错误中添加RetryableWriteError标签，如下所示的错误消息

Error { kind: ConnectionPoolCleared { message: "Connection pool for
localhost:27017 cleared because another operation failed with: Kind:
I/O error: timed out, labels: {}" }, labels: {"RetryableWriteError"},
wire_version: None, source: None }

此标签表示错误是可重试的写入错误，这意味着驱动程序将尝试重试一次。

写入错误类型

当驱动程序在执行写操作时遇到错误，它会抛出一个具有 kind 字段值为 Write 的 Error 实例。Write 变体的主体是枚举 WriteFailure，它接受类型为 WriteError 或 WriteConcernError 的值。

Error: Error { kind: Write(WriteError(WriteError { code: 121, code_name:
None, message: "Document failed validation", details:
Some(Document({"failingDocumentId": Int32(1), "details":
Document({"operatorName": String("$jsonSchema"), "title":
String("Numerical Validation"), "schemaRulesNotSatisfied":
Array(...)})})) })), labels: {},
wire_version: None, source: None }