Errores de conexión a BD | Soluciones WordPress y PrestaShop

¡Hola! Si estás leyendo esto, es muy probable que te hayas topado con una pantalla de error en tu web que te impide acceder a ella. No te preocupes, es uno de los sustos más comunes en el mundo del hosting, y la buena noticia es que casi siempre tiene solución.

En este artículo, vamos a desglosar los errores de conexión a base de datos más frecuentes en WordPress y PrestaShop. Te explicaré, paso a paso y sin tecnicismos innecesarios, cómo identificar el problema y cómo solucionarlo para que tu tienda o blog vuelvan a la vida en cuestión de minutos.

Vamos a ello.

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

Antes de ponernos manos a la obra, es importante entender qué está pasando. Imagina que tu web es una tienda física.

La base de datos es el almacén donde guardas todos tus productos, precios, clientes y pedidos. El código de tu web (WordPress o PrestaShop) es el dependiente que atiende a los clientes. Cuando alguien entra en tu web, el dependiente va al almacén a buscar la información para mostrarla.

Un error de conexión a la base de datos significa que el dependiente no puede abrir la puerta del almacén. Puede ser porque ha perdido la llave (credenciales incorrectas), porque la cerradura ha cambiado (el servidor de la base de datos ha cambiado), o porque el almacén está cerrado por reformas (el servidor de la base de datos está caído o sobrecargado).

Ahora que tenemos la metáfora clara, veamos los errores más comunes y cómo abrir esa puerta de nuevo.

Errores Comunes de Conexión en WordPress

WordPress es muy claro cuando tiene un problema de este tipo, pero a veces no lo suficiente. Aquí tienes los mensajes más típicos y su solución.

1. "Error al establecer una conexión con la base de datos"

Este es el error más genérico y famoso. Aparece cuando WordPress no puede conectar con tu base de datos en absoluto. Las causas más comunes son:

Credenciales incorrectas: El nombre de usuario, la contraseña, el nombre de la base de datos o el host no son los correctos en el archivo de configuración.
El servidor de base de datos está caído: Puede que el servidor MySQL esté sobrecargado o haya sufrido una caída temporal.
Archivos de configuración corruptos: El archivo wp-config.php puede estar dañado o tener información errónea.

Solución Paso a Paso

Vamos a revisar el archivo más importante: wp-config.php.

Accede a tu hosting: Necesitas un cliente FTP como FileZilla o el administrador de archivos de tu panel de control (cPanel, Plesk, o Syspanel, el cual puedes acceder a través del puerto 2106).
Localiza el archivo: Busca la carpeta raíz de tu WordPress (normalmente llamada public_html o www). Dentro, encontrarás un archivo llamado wp-config.php.
Descarga una copia de seguridad: Antes de tocar nada, descarga una copia a tu ordenador para poder restaurarlo si algo sale mal.
Edita el archivo: Ábrelo con un editor de texto plano (como el Bloc de notas o Sublime Text). Busca las líneas que dicen algo así:

// ** Ajustes de MySQL ** //
define( 'DB_NAME', 'tu_nombre_de_base_de_datos' );
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Verifica los datos: Ahora, ve a tu panel de control del hosting (cPanel, Plesk o Syspanel en el puerto 2106) y busca la sección "Bases de Datos MySQL". Allí podrás ver el nombre exacto de la base de datos, el usuario y la contraseña.

[!INFO]
IMPORTANTE: A veces, la contraseña puede contener caracteres especiales como $, #, % que, al estar dentro de las comillas del archivo, pueden ser interpretados de forma incorrecta. Si tu contraseña los contiene, una solución rápida es cambiarla desde tu panel de control y usar una nueva que solo tenga letras y números.

Guarda y sube: Corrige los datos que sean necesarios, guarda el archivo y súbelo de nuevo a tu hosting, sobrescribiendo el anterior.
Comprueba el host: Si los datos son correctos, el problema puede ser el DB_HOST. Normalmente es localhost, pero a veces es un servidor externo como mysql.tudominio.com. Si no estás seguro, contacta con tu proveedor de hosting.

2. "Una o más tablas de la base de datos no están disponibles"

Este error es un poco más específico. Indica que WordPress puede conectarse, pero que algunas tablas de la base de datos están dañadas o corruptas.

Solución: Reparar la Base de Datos

WordPress tiene una función oculta para reparar la base de datos. Vamos a activarla.

Edita wp-config.php: Igual que antes, localiza y descarga el archivo.
Añade la línea mágica: Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! */, añade esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda y sube el archivo.
Accede a la herramienta de reparación: Ahora, en tu navegador, ve a tudominio.com/wp-admin/maint/repair.php.
Repara la base de datos: Verás un botón que dice "Reparar base de datos" o "Reparar y optimizar base de datos". Haz clic en él y espera a que termine.
¡MUY IMPORTANTE! Una vez terminado, elimina la línea que añadiste en el paso 2 y vuelve a subir el archivo. Dejar esa línea activa es un riesgo de seguridad.

[!WARNING]
Nunca dejes la línea WP_ALLOW_REPAIR activa en tu archivo de configuración. Cualquier persona podría acceder a la herramienta de reparación y causar estragos. Es una solución temporal, no una configuración permanente.

3. "Error de base de datos al realizar una consulta" o "Error al conectar con la base de datos"

Estos errores suelen aparecer cuando el servidor de base de datos está sobrecargado o si un plugin o tema está realizando consultas demasiado complejas.

Solución: Optimizar y Revisar Plugins

Revisa los plugins: Desactiva todos los plugins. Puedes hacerlo desde el panel de administración (si es que puedes acceder a veces) o, si no, renombrando la carpeta wp-content/plugins a wp-content/plugins_backup mediante FTP. Esto desactivará todos los plugins a la vez.
Prueba tu web: Si el error desaparece, el problema era un plugin. Actívalos uno a uno hasta encontrar al culpable.
Optimiza la base de datos: Puedes usar plugins como WP-Optimize o WP-Sweep para limpiar y optimizar las tablas de la base de datos, reduciendo su tamaño y mejorando el rendimiento.
Aumenta la memoria de PHP: A veces, este error se debe a un límite de memoria bajo. Añade esta línea a tu wp-config.php:

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

Errores Comunes en PrestaShop

PrestaShop es una plataforma robusta, pero también tiene sus propios quebraderos de cabeza con las bases de datos.

1. "Link to database cannot be established" o "Error al conectar con la base de datos"

Este es el equivalente al error de WordPress. PrestaShop no puede conectarse a la base de datos.

Solución: Revisar Parámetros de Configuración

PrestaShop guarda su configuración de base de datos en dos archivos principales: app/config/parameters.php y config/settings.inc.php (este último en versiones antiguas).

Accede a tu hosting por FTP.
Localiza los archivos: Busca app/config/parameters.php. Si no lo encuentras, busca config/settings.inc.php.
Descarga y edita: Ábrelo y busca los parámetros que empiezan por database_:

'database_host' => '127.0.0.1',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_base_datos',
'database_password' => 'contraseña',

[!TIP]
En PrestaShop, el host suele ser 127.0.0.1 en lugar de localhost. Si ves que no funciona con un valor, prueba con el otro.

Verifica los datos: Al igual que en WordPress, asegúrate de que los datos coinciden con los de tu panel de control (Syspanel en el puerto 2106).
Guarda y sube: Sube el archivo modificado.

2. "Fatal error: Uncaught PDOException" o "Error de conexión PDO"

Este error es más técnico y suele aparecer en versiones más recientes de PrestaShop. Indica un problema con la extensión PDO de PHP o con las credenciales.

Solución: Verificar Requisitos del Servidor

Comprueba la versión de PHP: PrestaShop es exigente con las versiones de PHP. Asegúrate de que tu hosting tiene una versión compatible (PHP 7.4 u 8.0+ son las más seguras).
Habilita la extensión PDO_MySQL: En tu panel de control, busca la sección "Select PHP Version" o "Administrador de PHP". Asegúrate de que la extensión pdo_mysql está habilitada.
Revisa el parameters.php: A veces, este error se debe a un problema con la sintaxis del archivo. Si has editado algo y ha quedado mal, PrestaShop no puede leerlo correctamente. Vuelve a descargar el archivo original desde una copia de seguridad o desde la instalación de PrestaShop.

3. "La tienda no puede conectarse a la base de datos. Por favor, compruebe sus datos de conexión."

Este mensaje suele aparecer durante el proceso de instalación o migración de PrestaShop.

Solución: Verificar Privilegios del Usuario

Accede a tu panel de control (cPanel, Plesk o Syspanel en el puerto 2106).
Busca "Bases de Datos MySQL".
Comprueba el usuario: Asegúrate de que el usuario de la base de datos tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) sobre la base de datos. Puedes asignarlos marcando la casilla "TODOS LOS PRIVILEGIOS" en la gestión del usuario.
Crea un usuario nuevo: Si el usuario está bien pero sigue fallando, crea un usuario nuevo, asígnale todos los privilegios sobre la base de datos y actualiza los archivos parameters.php y settings.inc.php con las nuevas credenciales.

Consejos Generales y Prevención de Futuros Errores

Aquí tienes una lista de verificación y buenas prácticas para evitar estos sustos en el futuro:

Realiza copias de seguridad periódicas: Esta es la regla de oro. Tanto de los archivos como de la base de datos. Si algo sale mal, puedes restaurar tu web a un estado anterior en minutos.
No cambies las contraseñas de la base de datos sin antes actualizar los archivos de configuración: Es como cambiar la cerradura de tu casa sin dar la llave nueva a tu familia.
Mantén todo actualizado: Tanto el núcleo de WordPress/PrestaShop como los temas y plugins. Las actualizaciones corrigen errores y mejoran la compatibilidad con las versiones de PHP.
Usa contraseñas robustas: Para tu base de datos y para tu panel de control. Esto evita accesos no autorizados que puedan corromper o borrar datos.
Conoce tu panel de control: Si tu hosting usa Syspanel, recuerda que el acceso se realiza a través del puerto 2106. Familiarizarte con él te ayudará a gestionar tus bases de datos de forma más eficiente.
Contacta con tu soporte: Si después de seguir todos estos pasos el problema persiste, no dudes en contactar con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso a herramientas de diagnóstico más avanzadas.

Preguntas Frecuentes (FAQ)

¿Puedo perder mis datos si tengo un error de conexión a la base de datos?

En la mayoría de los casos, no. Un error de conexión no significa que tus datos se hayan borrado. Simplemente significa que tu web no puede acceder a ellos. Una vez que se soluciona el problema de conexión, tus datos volverán a estar disponibles.

¿Qué hago si he olvidado la contraseña de mi base de datos?

Puedes cambiarla desde el panel de control de tu hosting. Busca la sección "Bases de Datos MySQL", encuentra tu usuario y haz clic en "Cambiar contraseña". Después, deberás actualizar esta contraseña en el archivo wp-config.php (WordPress) o en app/config/parameters.php (PrestaShop).

¿Por qué veo el error solo a veces y no siempre?

Esto suele indicar un problema de sobrecarga del servidor. El servidor de base de datos está siendo utilizado por muchas personas a la vez y a veces no da abasto. Si es un problema constante, considera mejorar tu plan de hosting.

¿Es lo mismo un error de conexión que un error de "Base de datos corrupta"?

No. Un error de conexión significa que la web no puede comunicarse con la base de datos. Una base de datos corrupta significa que la web sí se comunica, pero los datos están dañados o son inconsistentes. Las soluciones son diferentes, como hemos visto.

Espero que esta guía completa te haya sido de gran ayuda. Los errores de base de datos son frustrantes, pero con un poco de paciencia y siguiendo estos pasos, podrás resolverlos tú mismo. ¡Mucha suerte y a seguir creciendo tu proyecto online!