操作错误处理

Overview

本页介绍了使用 MongoDB Rust 驱动程序执行 MongoDB 操作时可能遇到的错误。 了解驱动程序引发的操作错误类型后，就可以采取适当的操作来处理这些错误或更正导致错误的代码。

错误类型

如果驾驶员在执行操作时遇到错误，则会返回错误 类型的错误。

Error类型包含kind字段，该字段描述发生的错误类型。 kind字段的值为枚举 ErrorKind 。ErrorKind枚举具有针对不同类型错误的变体，其中包括：

• InvalidArgument：您为方法提供的参数无效

• Authentication：驱动程序在身份验证期间遇到错误

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

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

• Transaction：事务期间发生错误

例如，如果尝试执行与collection中已存在的字段值重复的插入操作，驱动程序将返回实例并打印以下错误消息：_idError

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 。错误消息描述了并发操作失败的原因。

要了解如何调整连接池以解决此错误，请参阅 MongoDB Server手册中的 调整连接池设置 。

根据产生错误的情况，驱动程序可能会为错误添加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 }