Solução de problemas de conexão

Verifique sua connection string

Verifique se o nome do host e o número da porta na connection string são precisos. O valor de porta padrão para uma instância do MongoDB é 27017, mas você pode configurar o MongoDB para se comunicar em outra porta.

Configurar firewall

Verifique se as portas nas quais sua implantação MongoDB escuta não estão bloqueadas por um firewall na mesma rede. O MongoDB usa a porta 27017 por padrão. Para saber mais sobre as portas padrão que o MongoDB usa e como alterá-las, consulte Porta padrão do MongoDB.

Certifique-se de que o MongoDB e seu cliente usem o mesmo protocolo

No Node.js v17 e versões posteriores, o resolvedor DNS usa IPv6 por padrão se o cliente e o host oferecem suporte a ambos. Por exemplo, se o MongoDB usar IPv4 e seu cliente usar IPv6, o driver gerará a mensagem de erro anterior.

Você pode configurar sua implantação do MongoDB para usar o modo IPv6 ao iniciar com mongod ou mongos. Para obter mais informações sobre como especificar o modo IPv6, consulte Vinculação de IP no manual do servidor.

Você também pode usar o IPv4 com seu cliente especificando o family: 4 como uma opção para seu MongoClient.

const client = new MongoClient(uri, {
  family: 4,
});

Controle o número de descritores de arquivos

Um descritor de arquivo é um identificador único associado a um processo aberto. Na maioria dos sistemas operacionais, cada conexão aberta do driver é associada a um descritor de arquivos. Os sistemas operacionais normalmente têm um limite de número de descritores de arquivos usados por um único processo. Um erro ECONNRESET poderá ocorrer se o número de conexões exceder esse limite.

Você pode definir o número máximo de conexões configurando maxPoolSize. Para solucionar este erro, você pode diminuir o número máximo de conexões permitidas configurando o valor de maxPoolSize. Como alternativa, você pode aumentar o limite do descritor de arquivos em seu sistema operacional.

Verifique sua connection string

Uma connection string inválida é a causa mais comum de problemas de autenticação ao tentar se conectar ao MongoDB usando SCRAM-SHA-256.

Se sua string de conexão contiver um nome de usuário e senha, certifique-se de que eles estejam no formato correto. Se o nome de usuário ou senha incluir qualquer um dos seguintes caracteres, eles devem usar codificação percentual:

: / ? # [ ] @

O exemplo abaixo mostra como codificar a porcentagem de "#MyP@assword?":

console.log(encodeURIComponent('#MyP@assword?'));

Isso resulta na seguinte saída:

"%23MyP%40assword%3F"

Verificar se o usuário está no banco de dados de autenticação

Para autenticar uma conexão corretamente usando um nome de usuário e uma senha com SCRAM-SHA-256, o nome de usuário deve ser definido no banco de dados de autenticação. O banco de dados de autenticação padrão é o banco de dados admin. Para usar outro banco de dados de autenticação, especifique o authSource na connection string. O exemplo abaixo orienta o driver a usar o users como banco de dados de autenticação:

const { MongoClient } = require("mongodb");
const uri = "mongodb://<username>:<password>@<hostname>:<port>/?authSource=users";
const client = new MongoClient(uri);

Você pode verificar se este é o problema tentando se conectar a uma instância do MongoDB hospedada na máquina local com o mesmo código. Um sistema na mesma máquina não exige qualquer autorização para se conectar.

Verifique as permissões do usuário

Verifique se você acessou o MongoDB deployment com o usuário correto. O termo "mensagem" no erro pode ser um comando enviado pelo driver. Se você estiver usando um usuário que não tem permissões para enviar o comando, o driver poderá gerar esse erro.

Certifique-se também de que o usuário tenha as permissões apropriadas para a mensagem que você está enviando. O MongoDB usa o RBAC (controle de acesso baseado em funções) para controlar o acesso a uma implantação MongoDB. Para obter mais informações sobre como configurar o RBAC no MongoDB, consulte Porta padrão do MongoDB.

Configurar firewall

O firewall precisa ter uma porta aberta para se comunicar com a instância do MongoDB. Para obter mais informações sobre como configurar o firewall, consulte Configurar firewall na seção Erro de conexão.

Verifique o número de conexões

Cada instância do MongoClient aceita um número máximo de conexões abertas simultâneas em seu pool de conexões. Você pode configurar o parâmetro maxPoolSize que define esse limite. O valor padrão é 100. Se já houver uma série de conexões abertas iguais a maxPoolSize, o servidor aguardará até que uma conexão se torne disponível. Se esse tempo de espera exceder o valor de maxIdleTimeMS, o driver responderá com um erro.

Para obter mais informações sobre como funciona o pool de conexões, consulte Como funciona o pool de conexões no driver de nó? na seção de Perguntas frequentes.

Verifique o número de conexões

Para criar mais conexões abertas, aumente o valor de maxPoolSize. Para obter mais informações sobre como verificar o número de conexões, consulte Verifique o número de conexões na seção Erro ao enviar mensagem.

Definir connectTimeoutMS

O driver pode travar quando não consegue estabelecer uma conexão porque leva muito tempo tentando alcançar nós de conjuntos de réplicas inacessíveis. Você pode limitar o tempo que o driver gasta tentando estabelecer a conexão utilizando a configuração connectTimeMS. Para saber mais sobre essa configuração, consulte as Opções de tempo limite no manual do servidor.

Você deve garantir que a configuração do connectTimeoutMS não seja menor que a latência de rede mais alta que você tem para um nó do conjunto. Se um dos secundários tiver uma latência de 10.000 milissegundos, definir o connectTimeoutMS para 9.000 impede que o driver se conecte a esse nó.

O exemplo a seguir define connectTimeoutMS em 10.000 milissegundos.

const client = new MongoClient(uri, {
  connectTimeoutMS: 10000,
});

Verifique o número de conexões

O número de conexões com o servidor pode exceder maxPoolSize. Para obter mais informações sobre como verificar o número de conexões, consulte Verificar o número de conexões na seção Mensagem de erro de envios.