¿Qué significa el código errno 48 (EADDRINUSE) en macOS?

EADDRINUSE

Qué significa EADDRINUSE en macOS

EADDRINUSE aparece cuando bind() no puede reservar el endpoint local. El conflicto no es solo “el mismo puerto”: también cuentan familia, IP concreta o wildcard, protocolo y opciones de reutilización.

En un reinicio rápido puede intervenir estado previo del socket, pero eso no convierte SO_REUSEADDR en una solución universal. Las opciones de reuse cambian las reglas de ownership y deben coincidir con el diseño del servicio.

Qué comprobar

• Registra familia, dirección, puerto, tipo/protocolo y opciones exactas del socket.
• Comprueba listeners sobre dirección específica y wildcard, incluida la interacción IPv4/IPv6.
• Identifica qué proceso mantiene el endpoint y si un supervisor/socket activation lo creó antes que la aplicación.
• En UNIX-domain sockets, distingue un proceso vivo de una entrada de pathname obsoleta antes de eliminarla.

Referencias técnicas

• XNU: Darwin errno definitions
• POSIX: bind()
• POSIX: connect()

¿Buscas un código diferente? Buscar otro código de estado o error.