SQLSTATE[HY000] [2002] Connection refused
SQLSTATE[HY000] [2002] Connection refused
PDO/MySQL no pudo establecer una conexión con el servidor de base de datos.
Qué significa
PDO/MySQL no pudo establecer una conexión con el servidor de base de datos.
Causa probable
El servicio de base de datos no está en ejecución, un host/puerto o ruta de socket incorrectos, o el servidor no es alcanzable desde la app (firewall, redes de contenedores).
Cómo solucionarlo
Confirma que la base de datos está en ejecución y es alcanzable, verifica el host, puerto y socket en tu configuración, y usa 127.0.0.1 en lugar de localhost si se pretende una conexión TCP (no un socket).
Otros errores de PHP
Acerca de Buscador de códigos de error
El Buscador de Códigos de Error es un directorio consultable con más de 200 mensajes y códigos de error comunes en 12 categorías: códigos de estado HTTP, códigos de error de Windows, errores de navegador y de red, JavaScript, Python, PHP, Node.js y npm, Java, MySQL, Git, errores de shell de Linux y códigos de correo/SMTP. Cada entrada está escrita en lenguaje sencillo para una resolución rápida.
Cada error se explica en tres partes: qué significa realmente el mensaje, qué lo suele causar y qué pasos concretos lo solucionan. Esa estructura convierte una cadena críptica como ERR_CONNECTION_REFUSED o 0x80070005 en una lista de comprobación accionable en lugar de un juego de adivinanzas.
Puedes filtrar la lista por categoría, buscar por código, constante o fragmento del mensaje, y copiar cualquier código con un clic. Cada error también tiene su propia página dedicada con errores relacionados de la misma categoría, para que puedas guardar en marcadores o compartir un enlace directo a la solución exacta.
Cómo usar Buscador de códigos de error
- Escribe el código o mensaje de error en el cuadro de búsqueda, por ejemplo 404, ERR_NAME_NOT_RESOLVED o 0x80070005.
- Reduce los resultados con el filtro de categoría (HTTP, Windows, JavaScript, MySQL, etc.) si la búsqueda devuelve demasiadas entradas.
- Abre la entrada correspondiente para leer qué significa, su causa probable y cómo solucionarlo.
- Usa el botón de copiar para obtener el código exacto para un informe de error o un ticket de soporte.
- Consulta la sección de errores relacionados para ver otros errores de la misma categoría.