Solucionar error de conexión a base de datos en WordPress y PrestaShop

¡Hola! Soy tu técnico de soporte de confianza y sé que este mensaje puede ser desalentador, pero no te preocupes. Ver el temido "Error estableciendo conexión con la base de datos" en WordPress o PrestaShop es uno de los problemas más comunes en el mundo del hosting, y en el 90% de los casos tiene una solución rápida y sencilla.

Este error significa que tu sitio web (escrito en PHP) no puede comunicarse con tu base de datos (MySQL/MariaDB). Piensa en ello como un restaurante: el sitio web es el camarero y la base de datos es la cocina. Si el camarero no puede llegar a la cocina, no puede servir la comida (tu contenido) a los clientes (tus visitantes).

En esta guía extensa, vamos a desglosar, paso a paso y en un lenguaje muy claro, todas las soluciones posibles para arreglar el error base de datos wordpress y el error conexión bd prestashop. No necesitas ser un experto en Linux o SysAdmin para seguir estos pasos, solo un poco de paciencia y acceso a tu panel de control.

Vamos a ello.

Primeros Pasos: Diagnóstico Rápido (¿Estás Solo Tú o Es General?)

Antes de empezar a tocar archivos, hagamos una prueba rápida. Esto nos dirá si el problema es con la base de datos en sí o con el sitio web.

1. Accede a `wp-admin` o `/admin` (El Panel de Administración)

Intenta acceder a tu panel de administración. Normalmente es tudominio.com/wp-admin para WordPress o tudominio.com/admin para PrestaShop.

Si el panel carga correctamente: El problema es solo la lectura pública de la web. Suele ser un fallo de caché o un problema de permisos temporal. A veces, simplemente recargar la página o limpiar la caché del navegador lo soluciona.
Si el panel también da error: El problema es más profundo y afecta a toda la conexión. Sigue leyendo, porque tenemos que revisar la configuración y el servidor.

2. Prueba con el Archivo `wp-config.php` (Solo WordPress)

Vamos a ver si la base de datos responde. Crea un archivo llamado test.php en la raíz de tu hosting (donde está wp-config.php) con el siguiente contenido:

<?php
$connection = mysqli_connect("localhost", "tu_usuario", "tu_contraseña");
if (!$connection) {
    die("Error de conexión: " . mysqli_connect_error());
} else {
    echo "¡La conexión a MySQL es exitosa!";
}
?>

[INFO] Esto es solo una prueba. Si ves el mensaje de éxito, significa que tu base de datos está viva y que el problema está en la configuración de WordPress. Si ves un error, es que la base de datos está caída o los datos de acceso son incorrectos. Borra este archivo después de la prueba.

Solución 1: Verificar los Datos de Acceso (El Error Más Común)

El fix database error más habitual es que los datos de acceso a la base de datos hayan cambiado o estén mal escritos. Esto ocurre al migrar de hosting, al restaurar una copia de seguridad o si alguien cambió la contraseña de MySQL.

Para WordPress: El Archivo `wp-config.php`

Este archivo contiene la configuración clave. Debes buscarlo en la raíz de tu instalación (carpeta public_html o www). Ábrelo con un editor de texto (como Notepad++ o el editor del panel de control).

Busca estas líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_usuario');
define('DB_HOST', 'localhost');

Debes verificar que estos datos coincidan exactamente con los de tu base de datos. A veces, el DB_HOST no es localhost, sino algo como mysql.tudominio.com o una IP específica. Esto es especialmente común en hosting compartido.

Para PrestaShop: El Archivo `parameters.php`

PrestaShop guarda esta información en un archivo llamado parameters.php, que se encuentra en la ruta config/ dentro de la raíz de tu instalación. Búscalo y edítalo. Busca la sección parameters y verifica que los valores database_host, database_name, database_user y database_password sean correctos.

[TIP] Si no recuerdas la contraseña de tu base de datos, ve a tu panel de control de hosting (cPanel, Plesk o Syspanel) y búscala o cámbiala desde el administrador de bases de datos MySQL. Recuerda que si la cambias, debes actualizar el archivo wp-config.php o parameters.php con la nueva contraseña. Si usas Syspanel, recuerda que el puerto de acceso es el 2106.

Solución 2: Reparar la Base de Datos (Corrupción de Tablas)

A veces, las tablas de la base de datos se corrompen (por cortes de energía, errores de escritura, etc.). Tanto WordPress como PrestaShop tienen herramientas para intentar repararlas.

Reparar con WordPress (wp-config.php)

Añade esta línea a tu archivo wp-config.php, justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y ve a esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php

Verás una página con opciones para Reparar o Reparar y Optimizar la base de datos. Haz clic en "Reparar" y espera a que termine.

[WARNING] ¡IMPORTANTE! Después de la reparación, elimina esta línea del archivo wp-config.php. Dejarla activa es un riesgo de seguridad, ya que cualquiera podría intentar reparar tu base de datos. Es un paso crítico en el solucionar error mysql.

Reparar con PrestaShop

PrestaShop es un poco más complejo. Puedes intentar acceder a tudominio.com/admin/ y, si el panel carga, ir a Parámetros Avanzados > Base de Datos y usar el botón "Reparar" si existe. Si no, tendrás que hacerlo manualmente desde Syspanel o phpMyAdmin.

Usar phpMyAdmin para Reparar Manualmente

Este es el método más fiable y sirve para ambos CMS.

Accede a Syspanel (puerto 2106) o a cPanel.
Busca la aplicación phpMyAdmin (o "Bases de datos MySQL").
Selecciona tu base de datos en el menú lateral izquierdo.
Verás una lista de tablas. Marca la casilla superior para seleccionarlas todas.
En el menú desplegable inferior, elige "Reparar tabla".
Espera a que se ejecute. Te mostrará un mensaje de éxito o error.

Solución 3: Reiniciar el Servicio MySQL/MariaDB

Si la base de datos está "colgada" o sobrecargada, a veces solo necesita un reinicio. Esto se hace desde el servidor, no desde el panel de control. Si tienes acceso SSH o un VPS, sigue estos pasos.

En un VPS con Linux (Comandos Básicos)

Accede por SSH y ejecuta uno de estos comandos según tu sistema operativo:

# Para sistemas con systemd (Ubuntu 16.04+, Debian 8+, CentOS 7+)
sudo systemctl restart mysql
# o
sudo systemctl restart mariadb

# Para sistemas más antiguos (init.d)
sudo service mysql restart
# o
sudo service mariadb restart

[INFO] Si no sabes cuál es, prueba con systemctl primero. Si te da un error, usa service. Después de reiniciar, intenta cargar tu web.

Solución 4: Comprobar el Espacio en Disco y los Límites del Servidor

Un error de conexión también puede aparecer si el disco duro del servidor está lleno. MySQL necesita espacio temporal para funcionar.

Revisar el Espacio en Disco

Desde Syspanel (puerto 2106) o cPanel, busca la sección de "Uso de Disco" o "Estadísticas". Si está al 100%, tendrás que eliminar archivos temporales, copias de seguridad antiguas o logs de error.

También puedes revisar los límites de memoria PHP. Si tu sitio tiene un pico de tráfico y el servidor se queda sin memoria, MySQL puede rechazar conexiones. Aumentar el límite de memoria en el archivo wp-config.php o php.ini puede ayudar temporalmente.

Aumentar la Memoria PHP (WordPress)

Añade esta línea a wp-config.php:

define('WP_MEMORY_LIMIT', '256M');

Solución 5: Problemas de Permisos y Propiedad de Archivos

En servidores Linux, los archivos tienen un propietario y un grupo. Si los permisos son incorrectos, PHP no puede leer la configuración, lo que provoca que no pueda conectarse a la base de datos.

Los Permisos Correctos

Carpetas (Directorios): Deben tener permisos 755.
Archivos: Deben tener permisos 644.

Puedes cambiar estos permisos desde el administrador de archivos de Syspanel (puerto 2106) o cPanel. Selecciona todos los archivos de tu sitio y haz clic en "Permisos" o "Cambiar permisos".

[WARNING] No pongas permisos 777 en todo, es un riesgo de seguridad grave. Solo usa 755 para carpetas y 644 para archivos.

Solución 6: Cambiar el Host de la Base de Datos (Hosting Compartido)

A veces, el problema no está en tus archivos, sino en la IP del servidor de base de datos. Si tu hosting compartido ha cambiado de servidor, la IP de MySQL puede haber cambiado.

En tu panel de control (cPanel o Syspanel), busca la sección de "Bases de datos MySQL". A menudo, encontrarás el nombre del servidor de base de datos, que suele ser localhost o una URL como mysql.tudominio.com. Si ves una IP, verifica que coincida con la que tienes en tu wp-config.php o parameters.php.

Si acabas de migrar de hosting, es muy probable que el DB_HOST haya cambiado. Pregunta al soporte de tu nuevo hosting cuál es el host correcto.

Solución 7: Flush de Caché y DNS

A veces, el error es un falso positivo causado por una caché corrupta.

Limpia la caché de tu navegador: Prueba en modo incógnito.
Limpia la caché de WordPress: Si tienes un plugin de caché (como W3 Total Cache), renombra la carpeta wp-content/cache a cache_old para eliminarla temporalmente.
Limpia la caché de PrestaShop: Ve a la carpeta var/cache y borra su contenido (excepto el archivo .htaccess si existe).
Flush de DNS: En tu ordenador, abre el símbolo del sistema (CMD) y escribe ipconfig /flushdns y presiona Enter.

Preguntas Frecuentes (FAQ)

¿Por qué mi web muestra este error solo a veces?

Esto suele indicar un problema de sobrecarga en el servidor. MySQL se cae momentáneamente y se recupera. Revisa los logs de error de MySQL en tu panel de control (a menudo en "Registros de errores" o "Error Logs").

¿Puedo perder mis datos si intento reparar la base de datos?

La herramienta de reparación de MySQL no borra datos, solo intenta arreglar las tablas dañadas. Pero siempre es recomendable hacer una copia de seguridad antes de cualquier operación.

¿Qué hago si nada de esto funciona?

Si has seguido todos los pasos y el error base de datos wordpress o el error conexión bd prestashop persiste, es probable que el problema esté en el servidor de base de datos en sí (caído o bloqueado). En ese caso, contacta con tu proveedor de hosting. Ellos pueden ver los logs del servidor y reiniciar el servicio MySQL de forma segura. Menciona que ya has verificado los archivos de configuración y los permisos.

Resumen Final

El error de conexión a la base de datos es frustrante, pero es uno de los problemas más fáciles de diagnosticar si sigues un orden lógico. Recuerda la regla de oro:

Verifica los datos de acceso (usuario, contraseña, host).
Repara la base de datos (phpMyAdmin es tu amigo).
Reinicia el servicio MySQL (si tienes acceso a SSH).
Comprueba los permisos de archivos y el espacio en disco.

Con un poco de paciencia y estos pasos, tu web volverá a estar en línea. ¡No te rindas! Si te quedas atascado, la comunidad y tu soporte de hosting están para ayudarte. ¡Buena suerte!