Manejo de errores de operación

Overview

Esta página describe los errores que podrías encontrar al usar el controlador Rust de MongoDB para realizar operaciones en MongoDB. Una vez que entiendas los tipos de errores de operación que el driver genera, puedes tomar las acciones adecuadas para gestionarlos o corregir el código que causa los errores.

Tipo de error

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

La Error type contiene el campo kind, que describe el tipo de error que ha ocurrido. El campo kind tiene un valor de enumeración ErrorKind. El enum ErrorKind tiene variantes para diferentes tipos de errores, incluidos los siguientes:

• InvalidArgument: proporcionaste 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

• WriteSe produjo un error durante una operación de guardar

• 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 campo kind es Write. Para obtener más información sobre este tipo de error, consulte la sección Tipos de errores de guardado de esta guía.

Errores de conexión

Un error de operación concurrente podría borrar el pool de conexiones, interrumpiendo tu conexión con el servidor. En esta situación, el driver genera un tipo Error en el que el valor del campo kind es ConnectionPoolCleared. El mensaje de error describe la razón por la que la operación concurrente falló.

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 driver podría añadir 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 puede ser reintentado en guardado. Esto significa que el driver realiza un intento de reintento.

Guardar Tipos de errores

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 }