TNS-12541
Sem listener no host:porta
O TNS-12541 / ORA-12541 (“TNS:no listener”) tem um significado bastante preciso: o cliente conseguiu resolver o endereço e chegou até o servidor, mas não havia nada escutando no host e porta informados.
É um erro mais fácil de diagnosticar que o ORA-12154, porque a resolução de nomes já funcionou. As possibilidades se resumem a três: o listener não está no ar, está escutando em outra porta ou endereço, ou existe um firewall bloqueando o caminho.
O que significa
Nada escutando no endereço/porta que o cliente tentou — listener parado, porta errada, ou firewall dando reject.
Como o erro aparece
ORA-12541: TNS:no listener
Passo a passo do diagnóstico consultas somente leitura
Verifique se o listener está no ar (no servidor)
lsnrctl status
Confirme em qual porta e endereço ele escuta
ss -ltnp | grep 1521
Teste a partir do cliente
tnsping meu_alias
Teste a conectividade TCP pura, sem envolver o Oracle
Isso separa definitivamente “problema de rede/firewall” de “problema do listener”:
Teste de porta
curl -v telnet://servidor:1521 # Linux Test-NetConnection servidor -Port 1521 # Windows PowerShell
Se o listener estiver parado, inicie-o
lsnrctl start
Ação imediata
Confirme listener no ar e porta correta.
Correção definitiva
lsnrctl start; corrigir porta/host no cliente; regra de firewall.
Erros comuns — o que não fazer
- Assumir que o listener caiu sem verificar. Frequentemente ele está no ar, mas escutando em outra porta ou em um endereço diferente do que o cliente está tentando.
- Esquecer do firewall. Se o
lsnrctl statusmostra o listener ativo no servidor mas o cliente não conecta, o teste de porta pura resolve a dúvida em segundos. - Confundir com ORA-12514: se você recebeu 12514, o listener está no ar e respondeu — o problema é o serviço solicitado, não a ausência do listener.
Perguntas frequentes
O que significa ORA-12541 TNS:no listener?
Significa que o cliente conseguiu resolver o endereço do servidor, mas não encontrou nenhum listener escutando no host e na porta informados. As causas mais comuns são o listener parado, configurado em outra porta ou um firewall bloqueando a conexão.
Qual a diferença entre ORA-12541 e ORA-12514?
No ORA-12541 não há listener respondendo no endereço e porta. No ORA-12514 o listener está no ar e respondeu, mas não conhece o service name solicitado — normalmente porque a instância não está registrada nele.
Erros relacionados (Rede & TNS)
Vinicius Gabriel Lana
Sócio & CTO na MigraTI Soluções em TI · 8 anos como DBA (Oracle, SQL Server, PostgreSQL, MySQL)