28 PathNotViable: Cannot use the part of the path to traverse the element (no se puede usar esa parte de la ruta para recorrer el elemento)

¿Qué significa?

Una actualización intentó recorrer una ruta de campo con puntos (p. ej., a.b.c), pero una parte de la ruta encontró un tipo que no puede contener subcampos (un valor escalar o un elemento del tipo equivocado). Por eso no se pudo recorrer la ruta.

¿Por qué ocurre?

Escribir en una ruta anidada como a.b.c cuando el campo 'a' del documento es un escalar (p. ej., número/cadena) en lugar de un objeto/array; o discrepancias de tipo como encontrar un objeto donde se espera un índice de array. Habitual en documentos con un esquema inconsistente (al actualizar rutas profundas con $set).

Cómo solucionarlo

Antes de actualizar, asegúrese de que la ruta sea del tipo esperado (objeto/array). Corrija los documentos incompatibles o haga que la actualización dependa de la estructura del documento. Si es necesario, convierta primero el campo al tipo correcto (p. ej., sustituya el valor escalar por un objeto) y después escriba el campo anidado. Considere la validación de esquema para mantener la consistencia del esquema.