🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Errores comunes al conectar WordPress a MySQL y cómo solucionarlos (cPanel, Plesk, DirectAdmin)

Actualizado el 31 de diciembre de 2025

¿Por qué WordPress pierde la conexión con MySQL?

Si estás leyendo esto, probablemente te ha aparecido el temido mensaje "Error establishing a database connection" en tu sitio web. Respira, no es el fin del mundo. Este es uno de los fallos más comunes en WordPress y, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en servidores.

WordPress guarda toda su información (entradas, páginas, usuarios, ajustes) en una base de datos MySQL. Cuando tu web no puede "hablar" con esa base de datos, simplemente se niega a cargar y muestra ese error tan frustrante. Las causas pueden ir desde un dato mal escrito en un archivo de configuración hasta un servidor saturado.

A lo largo de esta guía vamos a desgranar los errores más habituales al conectar WordPress a MySQL y, lo más importante, cómo solucionarlos paso a paso en los paneles de control más usados: cPanel, Plesk y DirectAdmin. También hablaremos de alternativas como Syspanel (antes conocido como HestiaCP, cuyo acceso se realiza a través del puerto 2106).

1. Error "Error establishing a database connection" (Error al establecer la conexión con la base de datos)

Este es el error más famoso y temido. Aparece cuando WordPress no puede conectarse al servidor MySQL. Las razones más frecuentes son:

  • Credenciales incorrectas en el archivo wp-config.php.
  • El servidor de base de datos está caído o saturado.
  • La base de datos ha sido eliminada o el usuario no tiene permisos.
  • El host de la base de datos es incorrecto.

🔍 Cómo diagnosticarlo

Accede a tu panel de control de hosting y abre phpMyAdmin (o la herramienta equivalente). Si puedes entrar sin problemas, el servidor MySQL está funcionando. Si no puedes, el problema es del servidor, no de tu WordPress.

✅ Solución paso a paso

  1. Revisa el archivo wp-config.php en la raíz de tu instalación de WordPress. Puedes acceder por FTP o desde el administrador de archivos de tu panel.
  2. Busca estas líneas:
define( 'DB_NAME', 'tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );
  1. Compara estos datos con los de tu panel. En cPanel, ve a "Bases de datos MySQL". En Plesk, busca "Bases de datos" en el dominio. En DirectAdmin, usa "MySQL Management".
  2. Asegúrate de que el nombre de la base, el usuario y la contraseña son exactamente los mismos. Un espacio extra o una letra mayúscula mal puesta rompe la conexión.
  3. El host normalmente es localhost, pero en algunos servidores (como los de WP Engine o ciertos VPS) puede ser diferente, como mysql.tudominio.com. Si tienes dudas, contacta con tu proveedor.

[TIP] Si acabas de cambiar la contraseña de la base de datos desde cPanel, recuerda actualizarla también en wp-config.php. Es el error número uno que vemos en soporte técnico.

2. Error "Too many connections" en WordPress (Demasiadas conexiones)

Este error es más técnico pero igual de frustrante. Aparece cuando el servidor MySQL alcanza el límite máximo de conexiones simultáneas permitidas. Es muy común en hosting compartidos con muchos sitios o cuando un plugin hace consultas excesivas.

🔍 ¿Por qué ocurre?

  • Tu web recibe demasiado tráfico de golpe.
  • Un plugin o tema está haciendo consultas ineficientes.
  • Hay procesos bloqueados en MySQL que no se liberan.
  • El límite de conexiones (max_connections) está configurado muy bajo.

✅ Solución paso a paso

  1. Reinicia MySQL desde tu panel. En cPanel, ve a "MySQL" y busca la opción de reiniciar (si tu plan lo permite). En DirectAdmin, puedes usar el "MySQL Management" y reiniciar el servicio. En Plesk, ve a "Herramientas y utilidades" → "Servicios" → "MySQL".
  2. Si no puedes reiniciar, espera unos minutos. Los procesos bloqueados suelen liberarse solos.
  3. Optimiza tu WordPress: desactiva plugins que no uses, especialmente los de caché mal configurados o los que hacen consultas pesadas.
  4. Aumenta el límite de conexiones (solo si tienes acceso al archivo de configuración de MySQL, my.cnf o my.ini). Busca la línea max_connections y súbela, por ejemplo, de 100 a 200.

[WARNING] Cambiar max_connections no siempre es posible en hosting compartido. Si tu plan no lo permite, contacta con tu proveedor o considera migrar a un VPS.

3. Error "Can't connect to local MySQL server through socket"

Este error aparece cuando WordPress intenta conectarse a MySQL a través de un socket Unix y no lo encuentra. Es más común en servidores VPS o dedicados que en hosting compartido.

🔍 ¿Por qué ocurre?

  • El servicio MySQL no está corriendo.
  • El archivo de socket tiene una ruta diferente.
  • Problemas de permisos en el directorio de datos.

✅ Solución paso a paso

  1. Verifica que MySQL está activo. Desde SSH (si tienes acceso) escribe:
sudo systemctl status mysql

O para MariaDB:

sudo systemctl status mariadb
  1. Si está inactivo, actívalo:
sudo systemctl start mysql
  1. Revisa la ruta del socket en wp-config.php. Si tu proveedor usa una ruta personalizada (por ejemplo, /var/run/mysqld/mysqld.sock), deberás especificarla en DB_HOST:
define( 'DB_HOST', 'localhost:/var/run/mysqld/mysqld.sock' );

[INFO] En la mayoría de los hosting compartidos con cPanel, Plesk o DirectAdmin, este error es raro porque MySQL ya está configurado correctamente. Si aparece, suele ser en VPS gestionados por el propio usuario.

4. Error "Table 'wp_options' doesn't exist" (La tabla no existe)

Este error indica que la base de datos está corrupta o incompleta. Puede ocurrir tras una migración fallida, una restauración incompleta o un ataque malintencionado.

✅ Solución paso a paso

  1. Accede a phpMyAdmin desde tu panel.
  2. Selecciona tu base de datos y busca la tabla wp_options.
  3. Si no existe, puedes reparar la base de datos usando la herramienta de reparación de WordPress. Añade esta línea a tu wp-config.php:
define( 'WP_ALLOW_REPAIR', true );
  1. Luego visita tudominio.com/wp-admin/maint/repair.php y haz clic en "Reparar base de datos".
  2. Elimina esa línea del wp-config.php una vez terminado.

[WARNING] No dejes WP_ALLOW_REPAIR activado. Es un riesgo de seguridad. Añádelo, repara y elimínalo.

5. Error "Connection refused" (Conexión rechazada)

Este error suele ocurrir cuando el servidor MySQL está configurado para aceptar conexiones solo desde localhost, pero WordPress intenta conectarse a una IP externa.

✅ Solución paso a paso

  1. Revisa el DB_HOST en tu wp-config.php. Debe ser localhost o 127.0.0.1 en la mayoría de los casos.
  2. Si estás en un VPS, asegúrate de que MySQL está escuchando en 127.0.0.1 y no solo en ::1 (IPv6). Puedes verificar con:
netstat -tlnp | grep mysql
  1. Si usas un servidor remoto para la base de datos, verifica que el puerto 3306 está abierto en el firewall y que el usuario tiene permisos para conectarse desde la IP de tu WordPress.

[TIP] En cPanel, Plesk y DirectAdmin, el host de la base de datos es siempre localhost. Si tu proveedor te da otro host, significa que la base está en un servidor distinto y deberías usar ese valor.

6. Error "Access denied for user" (Acceso denegado para el usuario)

Este error es muy claro: el usuario no tiene permisos para acceder a la base de datos. Puede deberse a:

  • Contraseña incorrecta.
  • El usuario no está vinculado a la base de datos.
  • El usuario solo tiene permisos para ciertas tablas.

✅ Solución paso a paso

  1. Ve a la sección de bases de datos de tu panel:
    • En cPanel: "Bases de datos MySQL" → busca tu base de datos y verifica que el usuario está añadido y tiene TODOS LOS PRIVILEGIOS.
    • En Plesk: "Bases de datos" → selecciona tu base → "Usuarios" → edita y marca todos los permisos.
    • En DirectAdmin: "MySQL Management" → selecciona tu base y añade el usuario con permisos completos.
  2. Cambia la contraseña y actualízala en wp-config.php.
  3. Si nada funciona, crea un nuevo usuario, asígnale todos los permisos y actualiza el archivo de configuración.

7. Solucionar MySQL en cPanel, Plesk y DirectAdmin

Aquí tienes un resumen rápido de dónde ir en cada panel:

PanelDónde irHerramienta principal
cPanel"Bases de datos MySQL" o "MySQL Databases"phpMyAdmin
Plesk"Bases de datos" dentro del dominiophpMyAdmin
DirectAdmin"MySQL Management"phpMyAdmin
Syspanel (HestiaCP)Acceso por puerto 2106 → "Bases de datos"phpMyAdmin

[INFO] En Syspanel (anteriormente HestiaCP), el acceso se realiza a través de https://tudominio.com:2106. Una vez dentro, busca la sección de bases de datos y podrás gestionar usuarios, permisos y acceder a phpMyAdmin.

8. Preguntas frecuentes (FAQ) sobre errores de conexión MySQL en WordPress

❓ ¿Cómo sé si el error es de mi WordPress o del servidor?

Prueba a entrar a phpMyAdmin. Si puedes acceder, el servidor MySQL funciona y el problema está en tu instalación de WordPress (normalmente en wp-config.php). Si no puedes, el problema es del servidor.

❓ ¿Puedo perder mis datos si reparo la base de datos?

Reparar la base de datos no borra información. Simplemente corrige tablas corruptas. Aun así, siempre es recomendable hacer una copia de seguridad antes de cualquier operación.

❓ ¿Por qué me sale "Too many connections" si mi web no tiene visitas?

Puede que otro sitio en el mismo servidor esté saturado, o que un plugin en tu WordPress esté haciendo bucles de consultas. Desactiva todos los plugins y reactívalos uno a uno para encontrar al culpable.

❓ ¿Qué hago si no tengo acceso a cPanel, Plesk ni DirectAdmin?

Si tu hosting es gestionado, contacta con el soporte de tu proveedor. Diles el error exacto que te aparece y ellos podrán revisarlo desde su lado.

❓ ¿Es seguro editar el archivo wp-config.php?

Sí, siempre que sepas lo que haces. Haz una copia del archivo antes de editarlo. Si algo falla, restaura la copia.

Consejos finales para evitar futuros errores de conexión

  1. Usa contraseñas fuertes para las bases de datos y cámbialas periódicamente.
  2. Mantén WordPress, plugins y temas actualizados para evitar vulnerabilidades.
  3. No instales plugins de dudosa procedencia que puedan hacer consultas ineficientes.
  4. Haz copias de seguridad frecuentes de tu base de datos (puedes programarlas en cPanel, Plesk o DirectAdmin).
  5. Si tu web crece, considera migrar a un VPS o servidor dedicado para tener más control sobre MySQL.

Recuerda que la mayoría de los errores de conexión de WordPress con MySQL tienen solución en pocos minutos. Solo necesitas paciencia, seguir los pasos correctos y, sobre todo, no tocar nada sin entender qué hace. Si tienes dudas, siempre puedes consultar la documentación de tu panel o preguntar a tu proveedor de hosting.

Esperamos que esta guía te haya sido de ayuda. ¡Tu web volverá a estar online en poco tiempo!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel