28 PathNotViable: Cannot use the part of the path to traverse the element (não é possível usar essa parte do caminho para percorrer o elemento)

O que significa?

Uma atualização tentou percorrer um caminho de campo com pontos (por exemplo, a.b.c), mas parte do caminho encontrou um tipo que não pode conter subcampos (um valor escalar ou um elemento de tipo errado). Por isso, o caminho não pôde ser percorrido.

Por que acontece?

Escrever em um caminho aninhado como a.b.c quando o campo 'a' do documento é um escalar (por exemplo, número/string) e não um objeto/array; ou incompatibilidades de tipo, como encontrar um objeto onde se espera um índice de array. Comum em documentos com schema inconsistente (ao atualizar caminhos profundos com $set).

Como resolver

Antes de atualizar, garanta que o caminho seja do tipo esperado (objeto/array). Corrija os documentos incompatíveis ou torne a atualização condicional à estrutura do documento. Se necessário, primeiro converta o campo para o tipo correto (por exemplo, substitua o valor escalar por um objeto) e depois grave o campo aninhado. Considere a validação de schema para manter a consistência do schema.