// Referência de erro do Oracle

ORA-12170: TNS: ocorreu um tempo limite de conexão

O cliente desistiu de esperar a conexão: o host está inacessível, um firewall descarta o tráfego em silêncio ou o servidor foi lento demais para responder.

Código de erro
ORA-12170
Categoria
Conexão e login
Mensagem de erro
TNS:Connect timeout occurred

O que significa

ORA-12170 significa que a tentativa de conexão não foi concluída a tempo. Diferente do ORA-12541, nada recusou a conexão; os pacotes ficaram sem resposta. Isso aponta para a rede: um endereço IP errado, roteamento ou um firewall que descarta em vez de rejeitar.

Versões mais recentes adicionam detalhes: Cannot connect. timeout_type timeout of timeout for host_port., indicando qual timeout estourou.

Causas comuns

  • Um firewall ou grupo de segurança descartando o tráfego para a porta do listener.
  • Um endereço de host incorreto ou inacessível, por exemplo, um IP privado fora da rede.
  • Um servidor ou rede muito lento ou sobrecarregado, com um curto SQLNET.OUTBOUND_CONNECT_TIMEOUT ou CONNECT_TIMEOUT.

Como corrigir

  1. Teste a conectividade a partir da máquina cliente: nc -vz db-host 1521 ou tnsping. Se travar, o problema é o caminho de rede.

  2. Abra a porta do listener em todos os firewalls entre o cliente e o servidor, incluindo grupos de segurança em nuvem.

  3. Se a rede estiver apenas lenta, aumente o tempo limite de conexão no cliente sqlnet.ora (SQLNET.OUTBOUND_CONNECT_TIMEOUT) ou no descritor CONNECT_TIMEOUT.

Erros relacionados

Mais erros de conexão e login

O código e o texto da mensagem são de Ajuda de erros do Oracle Database. Veja toda a Lista de erros do Oracle ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com Oracle no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o Oracle e os outros bancos de dados que você usa.