// Referencia de errores de Oracle

ORA-12170: TNS: se produjo un tiempo de espera de conexión

El cliente agotó la espera al conectarse: el host es inaccesible, un firewall descarta el tráfico en silencio o el servidor tardó demasiado en responder.

Código de error
ORA-12170
Categoría
Conexión e inicio de sesión
Mensaje de error
TNS:Connect timeout occurred

Qué significa

ORA-12170 significa que el intento de conexión no se completó a tiempo. A diferencia de ORA-12541, nada rechazó la conexión: los paquetes se quedaron sin respuesta. Eso apunta a la red: una IP equivocada, un problema de enrutamiento o un firewall que descarta en lugar de rechazar.

Las versiones más recientes añaden detalle: Cannot connect. timeout_type timeout of timeout for host_port., indicando qué tiempo de espera se agotó.

Causas comunes

  • Un firewall o grupo de seguridad que descarta el tráfico hacia el puerto del listener.
  • Una dirección de host incorrecta o inalcanzable, por ejemplo una IP privada desde fuera de la red.
  • Un servidor o una red muy lentos o sobrecargados, con un corto SQLNET.OUTBOUND_CONNECT_TIMEOUT o CONNECT_TIMEOUT.

Cómo solucionarlo

  1. Prueba la accesibilidad desde la máquina cliente: nc -vz db-host 1521 o tnsping. Si se queda colgado, el problema está en la ruta de red.

  2. Abre el puerto del listener en todos los firewalls entre el cliente y el servidor, incluidos los grupos de seguridad en la nube.

  3. Si la red simplemente va lenta, aumenta el tiempo de espera de conexión en el cliente sqlnet.ora (SQLNET.OUTBOUND_CONNECT_TIMEOUT) o en el descriptor de CONNECT_TIMEOUT.

Errores relacionados

Más errores de conexión e inicio de sesión

El código y el texto del mensaje son de Ayuda para errores de Oracle Database. Explora la lista completa de Lista de errores de Oracle o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con Oracle en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para Oracle y las demás bases de datos que uses.