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

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con el temido mensaje de "Error al conectar con la base de datos" en tu WordPress o PrestaShop. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía extensa, te explicaré paso a paso cómo solucionar estos errores de conexión, desde lo más básico hasta ajustes más avanzados, todo explicado de forma clara y sencilla.

Vamos a dividir el contenido en dos grandes bloques: primero para WordPress y luego para PrestaShop, aunque muchos pasos son similares. Al final, incluiré una sección de preguntas frecuentes (FAQ) para resolver dudas concretas.

¿Qué significa "Error de conexión a la base de datos"?

Este error aparece cuando tu sitio web (WordPress o PrestaShop) no puede comunicarse con el servidor donde se almacena toda la información: usuarios, productos, entradas, configuraciones, etc. Es como si tu web perdiera la memoria. Las causas pueden ser varias:

Datos de acceso incorrectos en el archivo de configuración.
El servidor de base de datos (MySQL/MariaDB) está caído o saturado.
El usuario de la base de datos no tiene permisos suficientes.
Problemas con el proveedor de hosting (mantenimiento, cortes).
Conflictos con plugins o temas (más común en WordPress).
Corrupción de la base de datos.

Parte 1: Solucionar errores en WordPress

WordPress es muy transparente con este error. Normalmente verás un mensaje como: "Error al conectar con la base de datos" o "Error establishing a database connection". Sigue estos pasos en orden.

1.1. Verifica los datos en el archivo wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene el nombre de la base de datos, el usuario, la contraseña y el host. Un error tipográfico aquí es la causa más frecuente.

Pasos para revisarlo:

Accede a tu hosting mediante FTP (FileZilla, por ejemplo) o al administrador de archivos de tu panel de control (cPanel, Syspanel, etc.).
Navega hasta la carpeta raíz de tu instalación de WordPress (normalmente public_html o www).
Busca el archivo wp-config.php y ábrelo con un editor de texto (Bloc de notas o similar).

Localiza estas líneas (deben estar al principio):

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

Comprueba que los datos sean exactamente los que te proporcionó tu hosting. El host suele ser localhost, pero a veces es una IP o un nombre como mysql.servidor.com.
Si no estás seguro, contacta con tu proveedor de hosting o, si usas Syspanel (antes HestiaCP), puedes encontrar estos datos en la sección de bases de datos. Recuerda que el acceso a Syspanel es a través del puerto 2106 (ejemplo: tudominio.com:2106).

[TIP] Si cambiaste la contraseña de la base de datos desde el panel de control, debes actualizarla también aquí. Es un paso que se olvida muy a menudo.

1.2. Comprueba que el servidor de base de datos esté funcionando

A veces el problema no está en tu web, sino en el servidor de MySQL.

Cómo verificarlo:

Si tienes acceso a phpMyAdmin (desde cPanel o Syspanel), intenta iniciar sesión con los mismos datos del wp-config.php. Si no puedes, el servidor de base de datos podría estar caído.
Pregunta a tu hosting si hay algún mantenimiento programado o incidencia.
En Syspanel, ve a "Base de datos" y revisa el estado del servicio. Si ves algún error, contacta al soporte técnico.

[WARNING] No asumas que el servidor está bien solo porque tu web da error. A veces el servidor de base de datos y el servidor web son diferentes.

1.3. Repara la base de datos de WordPress

WordPress tiene una función oculta para reparar tablas dañadas.

Pasos:

Abre el archivo wp-config.php y añade esta línea justo antes del comentario "Eso es todo, ¡deja de editar!":
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Accede a esta URL en tu navegador (reemplaza tudominio.com por tu dominio real):
https://tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Elige la segunda para una revisión completa.
El proceso puede tardar unos segundos. Al finalizar, borra la línea que añadiste del wp-config.php por seguridad.

[INFO] Esta herramienta es segura, pero no la dejes activa permanentemente. Es solo para solucionar el error.

1.4. Desactiva plugins y temas (método manual)

Si el error aparece de repente después de instalar un plugin o cambiar de tema, puede haber un conflicto. Como no puedes acceder al panel de administración, hazlo manualmente.

Conéctate por FTP a tu hosting.
Ve a la carpeta wp-content/plugins.
Renombra la carpeta de un plugin sospechoso añadiendo -old al final (ejemplo: plugin-malo-old). Esto lo desactivará.
Si no sabes cuál es, renombra todas las carpetas de plugins a plugins-old. Luego, para reactivarlos, renómbralas de nuevo a plugins y activa uno por uno desde el panel.
Para el tema: en wp-content/themes, localiza la carpeta de tu tema activo y renómbrala. WordPress usará el tema por defecto (Twenty Twenty-Four, etc.) automáticamente.

1.5. Aumenta el límite de memoria de PHP (opcional)

A veces el error de conexión es en realidad un problema de memoria insuficiente. Añade esta línea en wp-config.php justo antes del cierre:

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

Parte 2: Solucionar errores en PrestaShop

En PrestaShop, el error puede aparecer como "No se puede conectar a la base de datos" o un mensaje similar durante la instalación o en el front-office. Los pasos son parecidos, pero con sus particularidades.

2.1. Revisa el archivo settings.inc.php

PrestaShop guarda la configuración de la base de datos en app/config/parameters.php (versiones modernas 1.7+) o en config/settings.inc.php (versiones 1.6 y anteriores).

Para PrestaShop 1.7+:

Accede por FTP a la carpeta raíz.
Abre app/config/parameters.php.

Busca estas líneas:

'database_host' => 'localhost',
'database_name' => 'nombre_bd',
'database_user' => 'usuario_bd',
'database_password' => 'contraseña_bd',

Verifica que sean correctos. En Syspanel, los datos están en la sección de bases de datos (puerto 2106).

Para PrestaShop 1.6 y anteriores:

Abre config/settings.inc.php.

Busca:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_bd');
define('_DB_USER_', 'usuario_bd');
define('_DB_PASSWD_', 'contraseña_bd');

[TIP] Si cambiaste la contraseña, recuerda actualizarla aquí también.

2.2. Verifica el estado del servidor MySQL

Igual que en WordPress, asegúrate de que el servidor de base de datos esté activo. Puedes probar a conectarte desde phpMyAdmin con los mismos datos. Si no funciona, contacta a tu hosting.

2.3. Repara la base de datos de PrestaShop

PrestaShop no tiene una herramienta de reparación automática como WordPress, pero puedes usar phpMyAdmin para reparar tablas.

Pasos en phpMyAdmin:

Accede a phpMyAdmin desde tu panel de control (cPanel, Syspanel, etc.).
Selecciona la base de datos de tu tienda.
Marca la opción "Seleccionar todo" (selecciona todas las tablas).
En el menú desplegable "Con seleccionados", elige "Reparar tabla".
Espera a que termine. Si hay muchas tablas, puede tardar un minuto.

[WARNING] Si la base de datos está muy dañada, puede que necesites restaurar una copia de seguridad. Siempre ten una copia reciente.

2.4. Limpia la caché de PrestaShop

A veces el error es por una caché corrupta. Puedes limpiarla manualmente:

Conéctate por FTP.
Elimina todo el contenido de la carpeta var/cache (PrestaShop 1.7+) o cache (PrestaShop 1.6).
También puedes eliminar la carpeta cache/smarty/cache y cache/smarty/compile.
Vuelve a cargar tu tienda.

2.5. Verifica los permisos del usuario de la base de datos

El usuario de la base de datos debe tener todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si tu hosting te permite gestionar permisos (en cPanel o Syspanel), asegúrate de que estén todos marcados. En Syspanel, al crear una base de datos, el usuario suele tener todos los permisos por defecto, pero vale la pena revisarlo.

Preguntas Frecuentes (FAQ)

Aquí tienes las dudas más comunes que resuelvo a diario:

¿Por qué aparece el error después de cambiar de hosting?

Es muy común. Al migrar, los datos de la base de datos (nombre, usuario, contraseña, host) cambian. Debes actualizar el archivo de configuración (wp-config.php o parameters.php) con los nuevos datos. Además, asegúrate de que la base de datos se haya importado correctamente.

¿Qué hago si no recuerdo la contraseña de la base de datos?

Puedes cambiarla desde el panel de control de tu hosting. En Syspanel (puerto 2106), ve a "Base de datos", selecciona la base de datos y cambia la contraseña del usuario. Luego, actualiza el archivo de configuración de tu web con la nueva contraseña.

¿El error puede deberse a un ataque o malware?

Sí, aunque es menos frecuente. Un ataque puede modificar tus archivos de configuración o dañar la base de datos. Si después de seguir todos los pasos el error persiste, escanea tu web con un plugin de seguridad (WordPress) o contacta a tu hosting para que revise los logs.

¿Cómo sé si el problema es del hosting o de mi web?

Prueba a acceder a phpMyAdmin. Si no puedes ni siquiera iniciar sesión, el problema es del servidor de base de datos (hosting). Si sí puedes acceder, pero tu web no, entonces el error está en la configuración de tu web (archivos o base de datos).

¿Qué pasa si el error aparece solo en algunas páginas?

Puede ser un problema de caché o de un plugin/tema específico. Limpia la caché de tu navegador y la de tu web (WordPress: plugins de caché; PrestaShop: carpeta var/cache). Si persiste, desactiva plugins uno por uno.

Conclusión y consejo final

Los errores de conexión a la base de datos pueden ser frustrantes, pero en el 90% de los casos se solucionan revisando los datos de acceso o contactando al soporte técnico de tu hosting. Recuerda:

Siempre ten una copia de seguridad de tu base de datos y archivos.
Anota los datos de acceso en un lugar seguro.
Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y ahí puedes gestionar todo lo relacionado con bases de datos.

[INFO] Si después de seguir todos estos pasos el error continúa, no dudes en contactar al soporte técnico de tu hosting. Ellos pueden revisar los logs del servidor y detectar problemas más profundos.

Espero que esta guía te haya sido de gran ayuda. ¡Tu web volverá a funcionar en poco tiempo! Si tienes alguna otra duda, ya sabes, estoy aquí para ayudarte.