Whitelist do MongoDB Atlas na Square Cloud

A Square Cloud usa alocação dinâmica de IP para suas aplicações. Isso significa que sua instância não mantém um IP fixo entre reinícios, então o MongoDB Atlas precisa permitir conexões de forma mais ampla.

1. O problema do IP dinâmico

Ao conectar um banco MongoDB Atlas à sua aplicação Square Cloud, você pode ver este erro:

MongoNetworkError: connection 0 to shard-xxx-xxx.mongodb.net:27017 closed

Esse problema acontece porque o Atlas não reconhece o IP de origem da sua aplicação, já que ele muda a cada reinício.

2. Por que isso acontece?

O MongoDB Atlas exige que você adicione os IPs de origem confiáveis na whitelist. Como a Square Cloud não fornece um IP estático, não é possível adicionar um único endereço fixo ao Atlas.

3. Como corrigir

Passo a passo

1. Abra o painel do MongoDB Atlas.
2. Acesse a seção de Network Access / IP Access List.
3. Adicione o endereço abaixo:

0.0.0.0/0

4. Salve a alteração.

Observação de segurança

Adicionar 0.0.0.0/0 permite conexões de qualquer IP para o seu cluster Atlas. Use essa configuração apenas quando necessário e revise as regras de segurança do MongoDB Atlas para limitar o acesso por usuário e firewall quando possível.

4. Testando a conexão

Depois de adicionar a whitelist no Atlas, tente conectar sua aplicação de novo. Se o erro persistir, verifique:

• Se o banco de dados está ativo no Atlas.
• Se a string de conexão está correta.
• Se a aplicação está usando o cluster Atlas certo.

5. O que fazer se ainda não funcionar?

• Confirme o nome do cluster e o usuário do MongoDB Atlas.
• Verifique se a aplicação está configurada para conectar na porta correta.
• Se você usa VPC ou regras adicionais no Atlas, ajuste-as de acordo.

Atualizado em: 30/04/2026