Manejo de errores de operación

Overview

Esta página describe los errores que pueden surgir al usar el controlador Rust de MongoDB para realizar operaciones de MongoDB. Una vez que comprenda los tipos de errores de operación que genera el controlador, podrá tomar las medidas necesarias para gestionarlos o corregir el código que los causa.

Tipo de error

Si el controlador encuentra un error al realizar una operación, devuelve un error del tipo Error.

El Error El tipo contiene el kind campo, que describe el tipo de error ocurrido. El kind campo tiene el valor de la enumeración ErrorKind. La ErrorKind enumeración tiene variantes para diferentes tipos de errores, entre ellas:

• InvalidArgument:proporcionó un argumento no válido a un método

• Authentication:el controlador encontró un error durante la autenticación

• ServerSelection:el cliente no pudo seleccionar un servidor para la operación

• Write:se produjo un error durante una operación de escritura

• Transaction: Ocurrió un error durante una transacción

Por ejemplo, si intentas realizar una operación de inserción que duplica el valor de campo _id que ya está en la colección, el controlador devuelve una instancia Error e imprime el siguiente mensaje de 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 }

En el mensaje de error anterior, el valor del kind campo Write es. Para obtener más información sobre este tipo de error, consulte la sección "Tipos de errores de escritura" de esta guía.

Errores de conexión

Un error de operación concurrente podría borrar el pool de conexiones e interrumpir la conexión con el servidor. En este caso, el controlador genera un tipo Error cuyo valor del campo kind es ConnectionPoolCleared. El mensaje de error describe el motivo del fallo de la operación concurrente.

Para aprender a ajustar tu pool de conexiones para resolver este error, consulta Configuración del ajuste de tu pool de conexiones en el manual del servidor.

Dependiendo de las circunstancias que produzcan el error, el controlador podría agregar una etiqueta RetryableWriteError al error, como se muestra en el siguiente mensaje de error:

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 }

Esta etiqueta indica que el error se puede volver a escribir, lo que significa que el controlador realiza un nuevo intento.

Tipos de errores de escritura

Cuando el driver experimenta un error al realizar una operación de guardado, genera una instancia de Error con un valor de campo kind de Write. El cuerpo de la variante Write es el enum WriteFailure, que toma un valor de tipo WriteError o 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 }