Solucionar Error de Conexión a la Base de Datos en WordPress y PrestaShop

¿Qué significa el error "Error de conexión con la base de datos"?

Cuando visitas tu tienda online o tu blog y de repente ves un mensaje como "Error al establecer una conexión con la base de datos", es normal que sientas un poco de pánico. Pero tranquilo, respira hondo. Este es uno de los problemas más comunes en el mundo del hosting 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 programación.

Este error aparece tanto en WordPress como en PrestaShop, y básicamente significa que tu web no puede comunicarse con el servidor donde se almacenan todos tus contenidos, productos, clientes y configuraciones. Sin esa comunicación, la página no puede cargar nada y muestra ese mensaje tan temido.

A lo largo de esta guía, vamos a explorar las causas más frecuentes y, lo más importante, las soluciones paso a paso para que tu web vuelva a funcionar en cuestión de minutos. No importa si eres principiante o si ya tienes algo de experiencia, aquí te lo explicamos todo de forma clara y didáctica.

Primeros pasos: no entres en pánico y verifica lo básico

Antes de lanzarnos a modificar archivos o reiniciar servicios, es fundamental que hagas una comprobación rápida. Muchas veces, el error de conexión con la base de datos es temporal y se resuelve solo.

Comprueba si el problema es general o solo tuyo

Abre tu web en una ventana de incógnito o desde otro dispositivo (por ejemplo, tu móvil con datos, no con el WiFi). Si el error persiste, entonces el problema es real y está en el servidor. Si por el contrario la web carga bien, es posible que se trate de un problema de caché local o de DNS de tu conexión.

Revisa si otros sitios en tu hosting funcionan

Si tienes más de una web en el mismo hosting, intenta acceder a otra. Si todas fallan, el problema es del servidor en general. Si solo falla la tuya, el problema está en la configuración de tu sitio.

[INFO] Muchos proveedores de hosting realizan tareas de mantenimiento nocturnas. Si el error aparece a altas horas de la madrugada, espera unos minutos y vuelve a intentarlo antes de hacer nada más.

Las 5 causas más comunes y sus soluciones

Vamos a desglosar las causas más habituales de este error y cómo solucionarlas. Sigue las secciones en orden, ya que van de lo más simple a lo más complejo.

1. Credenciales de acceso incorrectas (la causa más común)

WordPress y PrestaShop guardan los datos de acceso a la base de datos en un archivo de configuración. Si estos datos son incorrectos, la conexión falla. Esto puede pasar si has cambiado la contraseña de tu base de datos desde el panel de control de tu hosting y no has actualizado el archivo de configuración.

Para WordPress:

El archivo se llama wp-config.php y está en la raíz de tu instalación. Necesitas acceder a tu hosting vía FTP o a través del administrador de archivos de tu panel de control.

Pasos a seguir:

Localiza el archivo wp-config.php.
Ábrelo con un editor de texto plano (como el Bloc de notas).
Busca las líneas que definen DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.
Verifica que estos datos coinciden exactamente con los de tu base de datos. Normalmente los encuentras en la sección "Bases de datos MySQL" de tu panel de hosting.
Si no coinciden, corrígelos y guarda el archivo.

Para PrestaShop:

El archivo de configuración se llama parameters.php y se encuentra en la ruta config/ dentro de tu instalación.

Pasos a seguir:

Accede a la carpeta config de tu PrestaShop.
Abre el archivo parameters.php.
Busca la sección 'database_host', 'database_name', 'database_user' y 'database_password'.
Actualiza los valores con los datos correctos de tu base de datos.
Guarda los cambios.

[WARNING] Ten mucho cuidado al editar estos archivos. Un solo carácter mal colocado (una coma, una comilla) puede provocar que tu web muestre otro error diferente. Haz siempre una copia de seguridad del archivo antes de modificarlo.

2. El servidor de base de datos está caído o sobrecargado

A veces, el problema no es tuyo, sino del servidor que aloja tu base de datos. En los planes de hosting compartido, es posible que el servidor de bases de datos (normalmente MySQL o MariaDB) se haya detenido o esté temporalmente sobrecargado por el uso de otros usuarios.

¿Cómo comprobarlo?

Accede a tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.). Busca una sección llamada "Estado del servidor" o "Monitor de recursos". Si ves que el servicio MySQL está detenido o con un uso de CPU del 100%, ese es el problema.

Soluciones:

Reiniciar el servicio: Algunos paneles te permiten reiniciar el servicio de base de datos con un botón. En Syspanel (que como recordatorio, se accede por el puerto 2106), puedes encontrar esta opción en la sección de "Servicios".
Esperar: Si no tienes opción de reiniciarlo, la sobrecarga suele ser temporal. Espera de 10 a 15 minutos y vuelve a cargar tu web.
Contactar al soporte: Si el servicio está caído y no puedes reiniciarlo, contacta con el soporte técnico de tu hosting. Ellos podrán reiniciar el servidor de bases de datos por ti.

[TIP] Si este problema se repite con frecuencia, es una señal de que tu plan de hosting compartido no es suficiente para el tráfico que recibe tu web. Considera migrar a un VPS o a un hosting dedicado.

3. El servidor de base de datos está saturado por tu propia web

Esto es más común de lo que piensas. Si tu web recibe mucho tráfico o tienes plugins/módulos mal optimizados, tu base de datos puede recibir demasiadas consultas a la vez y colapsar.

Síntomas: El error aparece solo en momentos de mucho tráfico (por ejemplo, cuando publicas un nuevo artículo o lanzas una oferta).

Soluciones:

Optimiza tu base de datos: Desde el panel de control de tu hosting, busca una herramienta como "phpMyAdmin". Accede a tu base de datos y utiliza la opción "Optimizar tablas" (puedes seleccionarlas todas). Esto ayuda a limpiar y reorganizar los datos.
Instala un plugin de caché: En WordPress, plugins como W3 Total Cache o WP Super Cache reducen drásticamente las consultas a la base de datos. En PrestaShop, activa las opciones de caché en "Parámetros Avanzados > Rendimiento".
Revisa tus plugins/módulos: Desactiva temporalmente todos los plugins (en WordPress) o módulos (en PrestaShop). Si el error desaparece, reactívalos uno a uno para encontrar al culpable. A menudo, un plugin mal codificado es el origen del problema.

4. El archivo de configuración tiene una ruta incorrecta (el caso del `DB_HOST`)

En ocasiones, el problema no son las credenciales, sino la dirección del servidor de base de datos. En muchos hostings, el servidor de base de datos es localhost, pero en otros (especialmente en configuraciones más avanzadas o con servidores separados) puede ser una dirección IP o un nombre de host específico.

Para WordPress:

En el archivo wp-config.php, la línea DB_HOST suele ser localhost. Sin embargo, si tu hosting utiliza un servidor de base de datos externo, deberás cambiar esto.

Para PrestaShop:

En el archivo parameters.php, la clave 'database_host' debe contener la dirección correcta.

¿Cómo saber cuál es la dirección correcta?

Consulta la documentación de tu proveedor de hosting o el panel de control. En la sección de "Bases de datos" suele indicarse el "Host" o "Servidor". En Syspanel, por ejemplo, puedes encontrar esta información en los detalles de tu base de datos.

[WARNING] En algunos hostings, usar localhost cuando el servidor es remoto puede causar este error. Si tu proveedor te da una dirección específica, úsala.

5. Problemas con los permisos de los archivos

Aunque es menos común, los permisos incorrectos en los archivos de configuración pueden impedir que el sistema los lea correctamente, provocando el error de conexión.

¿Cómo solucionarlo?

WordPress: El archivo wp-config.php debe tener permisos de lectura para el servidor. Generalmente, los permisos correctos son 644 o 640. Puedes cambiarlos desde tu cliente FTP o desde el administrador de archivos del hosting.
PrestaShop: El archivo parameters.php y la carpeta config deben tener permisos similares. Normalmente, 644 para archivos y 755 para carpetas.

[INFO] Cambiar los permisos a estos valores es estándar y seguro. No los pongas a 777 (lectura, escritura y ejecución para todos), ya que es un riesgo de seguridad grave.

Solución avanzada: reparar tablas corruptas

Si has probado todo lo anterior y el error persiste, es posible que alguna tabla de tu base de datos esté corrupta. Esto puede pasar por cortes de luz, errores del servidor o una mala actualización.

Para repararlas, sigue estos pasos:

Accede a phpMyAdmin desde el panel de control de tu hosting.
Selecciona tu base de datos en el menú lateral izquierdo.
En la parte inferior, verás un enlace que dice "Comprobar todas" (o "Check All"). Haz clic en él.
En el menú desplegable que dice "Con seleccionadas", elige la opción "Reparar tablas" (o "Repair Table").
Confirma la acción.

Este proceso puede tardar unos segundos o minutos, dependiendo del tamaño de tu base de datos. Una vez terminado, intenta cargar tu web de nuevo.

[TIP] Esta opción de "Reparar" es una herramienta mágica en muchos casos. Es una de las primeras cosas que deberías probar si sospechas de un problema más profundo.

Cómo prevenir el error en el futuro

Una vez que hayas solucionado el problema, es buena idea tomar algunas medidas para evitar que vuelva a ocurrir.

Mantén todo actualizado: Actualiza siempre tu WordPress o PrestaShop, así como tus plugins, módulos y temas. Las actualizaciones suelen corregir errores de compatibilidad y seguridad que pueden causar problemas de base de datos.
Programa copias de seguridad: Asegúrate de tener copias de seguridad automáticas de tu web y de tu base de datos. Si algo sale mal, podrás restaurar todo rápidamente.
Elige un buen hosting: Un hosting de calidad con un buen soporte técnico y servidores estables es la mejor inversión para evitar este tipo de problemas. Si estás en un hosting muy económico y tienes problemas recurrentes, plantéate un cambio.
Monitorea el rendimiento: Herramientas como Google PageSpeed Insights o GTmetrix pueden darte pistas sobre si tu web está haciendo demasiadas consultas a la base de datos, lo que puede ser un síntoma de un problema futuro.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si repara la base de datos?

No, la operación de "Reparar" en phpMyAdmin no elimina datos. Solo intenta corregir errores internos de las tablas. Es un proceso seguro.

¿Qué hago si no encuentro el archivo `wp-config.php` o `parameters.php`?

Si no los encuentras en la raíz, es posible que tu web haya sido hackeada o que la instalación esté en una subcarpeta. Busca en la carpeta public_html o en la carpeta donde instalaste la web. Si no lo encuentras, contacta con tu soporte de hosting.

¿Por qué el error aparece solo en el móvil y no en el ordenador?

Esto suele ser un problema de caché local o de DNS. Prueba a borrar la caché de tu navegador móvil o a reiniciar el router. Si el error persiste solo en el móvil, es muy probable que no sea un problema real de tu web.

¿Es lo mismo el error de conexión que el error de "base de datos no encontrada"?

Sí, a menudo se usan indistintamente. El mensaje de "base de datos no encontrada" suele indicar que el nombre de la base de datos en la configuración es incorrecto. El de "error de conexión" suele indicar que el servidor de la base de datos no responde o las credenciales son malas.

Si todo falla, ¿qué debo hacer?

Contacta con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso a los registros del servidor y podrán ver el error exacto que está ocurriendo. Dales toda la información que puedas: qué has probado, cuándo empezó el error, etc. En Syspanel (puerto 2106), puedes abrir un ticket de soporte directamente desde tu panel de control.

Conclusión

El error de conexión con la base de datos es un contratiempo, pero casi siempre tiene solución. Hemos visto que las causas van desde un simple error de contraseña hasta un problema de corrupción de tablas. Siguiendo los pasos de esta guía, podrás diagnosticar y resolver el problema en la mayoría de los casos.

Recuerda siempre empezar por lo más simple (verificar credenciales) y avanzar hacia lo más complejo (reparar tablas). Y sobre todo, no dudes en pedir ayuda a tu proveedor de hosting si te sientes abrumado. Para eso están.

Esperamos que esta guía te haya sido de gran ayuda. Ahora ya tienes las herramientas y los conocimientos para enfrentarte a este error con confianza. ¡Tu web volverá a estar en línea en un abrir y cerrar de ojos!