Solucionar errores de conexión WordPress-MySQL en Plesk

Introducción: El dolor de cabeza de conectar WordPress con MySQL en Plesk

Conectar WordPress con una base de datos MySQL suele ser uno de los primeros pasos al montar un sitio web. Sin embargo, cuando usas Plesk como panel de control, pueden surgir varios errores típicos que, aunque parecen complejos, tienen soluciones muy sencillas. En este artículo, vamos a recorrer los errores más comunes que enfrentan los usuarios al vincular WordPress con MySQL en Plesk, y te daremos pasos claros para solucionarlos.

[INFO] Si eres nuevo en esto, no te preocupes. Vamos a explicar cada concepto como si fuera la primera vez. Al final, podrás resolver estos problemas por ti mismo.

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

Este es probablemente el mensaje más temido. Aparece cuando WordPress no puede comunicarse con MySQL. Las causas más frecuentes son:

Credenciales incorrectas en el archivo wp-config.php.
La base de datos no existe o está mal nombrada.
El usuario de MySQL no tiene permisos sobre la base de datos.
El servidor MySQL no está funcionando (raro, pero posible).

Cómo solucionarlo paso a paso

Verifica las credenciales en wp-config.php
Accede a tu sitio a través de FTP o el administrador de archivos de Plesk. Busca el archivo wp-config.php en la raíz de tu instalación de WordPress. Revisa estas líneas:
```
define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_mysql');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');
```
Asegúrate de que coincidan exactamente con los datos que creaste en Plesk.
Revisa que la base de datos exista
En Plesk, ve a Bases de datos. Busca el nombre que pusiste en DB_NAME. Si no aparece, créala de nuevo con el mismo nombre y usuario.
Comprueba los permisos del usuario
Dentro de la base de datos en Plesk, selecciona el usuario asociado y verifica que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.). Si no, asígnaselos.
Prueba la conexión manualmente
Puedes hacer una prueba rápida creando un archivo PHP como test.php en la raíz con este contenido:
```
<?php
$conexion = mysqli_connect('localhost', 'usuario', 'contraseña', 'basedatos');
if (!$conexion) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo 'Conexión exitosa';
mysqli_close($conexion);
?>
```
Si ves "Conexión exitosa", el problema está en el archivo wp-config.php. Si no, anota el error.

[TIP] Si usas Syspanel (el nombre que le damos a HestiaCP), el proceso es similar, pero accedes por el puerto 2106. Allí también puedes gestionar bases de datos y usuarios.

Error 2: "Table 'wp_options' doesn't exist" (La tabla 'wp_options' no existe)

Esto ocurre cuando la base de datos está creada pero vacía, o cuando se dañó alguna tabla durante la instalación.

Causas comunes

No ejecutaste el script de instalación de WordPress (el famoso "5 minutos").
La importación de una base de datos falló o se interrumpió.
Corrupción de tablas por un cierre inesperado del servidor.

Soluciones

Ejecuta la instalación de WordPress desde cero
Si acabas de crear la base de datos, ve a tudominio.com/wp-admin y sigue los pasos. Si ya tienes contenido, no hagas esto porque perderás datos.
Importa una copia de seguridad de la base de datos
En Plesk, ve a Bases de datos > selecciona tu base > Importar. Sube un archivo .sql válido. Asegúrate de que el archivo no esté corrupto.
Repara las tablas dañadas
Desde phpMyAdmin (en Plesk, lo encuentras en el menú de la base de datos), selecciona todas las tablas y elige "Reparar tabla" en el menú desplegable.

[WARNING] Antes de reparar, haz una copia de seguridad. Si no sabes cómo, pide ayuda a tu proveedor de hosting.

Error 3: "Cannot connect to MySQL server" (No se puede conectar al servidor MySQL)

Este error es más técnico y suele indicar un problema de red o configuración del servidor.

Posibles causas

El servidor MySQL no está en ejecución en el panel de Plesk.
El puerto de MySQL está bloqueado por un firewall.
El host de la base de datos no es 'localhost' (en algunos hosting compartidos usan otro nombre).

Pasos para resolverlo

Verifica el estado de MySQL en Plesk
Ve a Herramientas y configuraciones > Servicios (o similar). Busca MySQL y asegúrate de que esté "en ejecución". Si no, haz clic en "Iniciar".
Comprueba el nombre del host
En algunos casos, el host no es localhost sino algo como mysql.tudominio.com o 127.0.0.1. Pregunta a tu proveedor o revisa la documentación de Plesk.
Revisa las reglas del firewall
Si tienes acceso, asegúrate de que el puerto 3306 (por defecto de MySQL) esté abierto para conexiones locales. En Plesk, esto suele estar preconfigurado.

[INFO] Si usas Syspanel, el proceso es análogo: ingresa por el puerto 2106 y busca la sección de servicios.

Error 4: "Your PHP installation appears to be missing the MySQL extension" (Tu instalación de PHP parece no tener la extensión MySQL)

WordPress necesita una extensión PHP para comunicarse con MySQL. Si falta, no podrá conectar.

Cómo solucionarlo

Selecciona la versión correcta de PHP en Plesk
Ve a Configuración de PHP (dentro de tu dominio en Plesk). Elige una versión moderna (7.4, 8.0, 8.1, etc.) que incluya las extensiones mysqli y pdo_mysql.
Habilita las extensiones manualmente
En la misma sección, busca "Extensiones" y activa mysqli y pdo_mysql. Guarda los cambios.
Reinicia el servicio de PHP
En Plesk, esto suele hacerse automáticamente al guardar. Si no, reinicia desde Herramientas y configuraciones > Servicios.

[TIP] Si no ves las extensiones, contacta a tu hosting. Algunos planes tienen restricciones.

Error 5: "Headers already sent" (Encabezados ya enviados) o errores de sintaxis en wp-config.php

A veces, el problema no es de conexión sino de configuración del archivo wp-config.php. Un error común es tener espacios en blanco o caracteres extra antes de <?php o después de ?>.

Solución

Abre wp-config.php con un editor de texto plano (nunca Word o bloc de notas con formato).
Elimina cualquier espacio o línea en blanco antes de <?php y después de ?> (si existe la etiqueta de cierre, mejor quítala).
Verifica que no haya caracteres invisibles (como BOM) usando un editor avanzado como Notepad++.

[WARNING] No uses editores que agreguen formato. Un simple espacio puede romper todo.

Error 6: "Too many connections" (Demasiadas conexiones)

Esto ocurre cuando el límite de conexiones simultáneas a MySQL se ha alcanzado. Es común en sitios con mucho tráfico o plugins mal optimizados.

Cómo mitigarlo

Aumenta el límite de conexiones
En Plesk, ve a Configuración de MySQL (si tienes acceso) y cambia max_connections a un número mayor (ej. 150). Si no, pídeselo a tu hosting.
Optimiza los plugins de WordPress
Desactiva plugins que hagan muchas consultas a la base de datos, como los de caché mal configurados.
Usa un plugin de caché
Instala uno como W3 Total Cache o WP Super Cache para reducir las consultas directas a MySQL.

[INFO] En Syspanel (puerto 2106), también puedes ajustar estos parámetros desde la sección de bases de datos.

Preguntas frecuentes (FAQ)

¿Por qué aparece "Error de conexión a la base de datos" después de migrar mi sitio?

Es muy común. Al migrar, las credenciales en wp-config.php suelen quedar desactualizadas. Cámbialas por las nuevas de tu base de datos en Plesk.

¿Cómo sé si mi base de datos MySQL está funcionando en Plesk?

Ve a Herramientas y configuraciones > Servicios. Busca "MySQL" y verifica que el estado sea "En ejecución".

¿Puedo usar phpMyAdmin para solucionar errores?

Sí, desde Plesk puedes acceder a phpMyAdmin para cada base de datos. Allí puedes reparar tablas, ejecutar consultas SQL o verificar la estructura.

¿Qué hago si no tengo acceso a Plesk?

Contacta a tu proveedor de hosting. Ellos pueden verificar el estado del servidor MySQL y ayudarte con la configuración.

¿El error "Table doesn't exist" siempre significa que perdí mis datos?

No necesariamente. Si tienes una copia de seguridad, puedes importarla. Si no, revisa si la base de datos fue creada correctamente.

Conclusión: La paciencia es clave

Conectar WordPress con MySQL en Plesk puede parecer complicado al principio, pero la mayoría de los errores tienen soluciones directas. Recuerda siempre:

Verifica las credenciales una y otra vez.
Asegúrate de que la base de datos exista y tenga permisos correctos.
Mantén PHP actualizado con las extensiones necesarias.
Haz copias de seguridad antes de cualquier cambio importante.

[TIP] Si después de seguir todos estos pasos el problema persiste, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen acceso directo a los logs del servidor y pueden identificar el error exacto.

Esperamos que esta guía te haya sido útil. ¡Buena suerte con tu sitio WordPress en Plesk!