Errores de Conexión a Base de Datos en WordPress y PrestaShop | Soluciones

¿Por qué WordPress o PrestaShop no conectan con la base de datos?

Cuando tu web muestra el temido mensaje de "Error al establecer una conexión con la base de datos" en WordPress, o el equivalente en PrestaShop de "Error de conexión a la base de datos", el corazón de tu tienda o blog se detiene. Es uno de los fallos más comunes y, afortunadamente, casi siempre tiene solución sin necesidad de ser un experto en programación.

Antes de entrar en pánico, respira. Este error no significa que hayas perdido tus datos, sino que tu aplicación (WordPress o PrestaShop) no puede comunicarse con el servidor MySQL/MariaDB donde se almacena toda tu información. Esto puede deberse a un simple cambio de contraseña, un servidor caído, o un archivo de configuración con datos incorrectos.

En esta guía extensa y práctica, vamos a desglosar los errores más comunes al conectar a la base de datos, tanto en WordPress como en PrestaShop, y te daré las soluciones paso a paso para que puedas recuperar tu sitio en minutos. No necesitas ser un gurú técnico, solo seguir el orden lógico que te propongo.

El origen del problema: ¿Qué significa "error conexión base datos wordpress"?

El mensaje genérico "Error al establecer una conexión con la base de datos" en WordPress aparece cuando el archivo wp-config.php no puede autenticarse con el servidor de base de datos. Es la causa número uno de pánico entre los usuarios de hosting.

Piensa en ello como si intentaras abrir una puerta con una llave equivocada. Tu web (la llave) intenta abrir la cerradura (la base de datos) pero o la llave no es la correcta (credenciales mal), o la cerradura está rota (servidor caído), o la puerta no existe (base de datos eliminada).

El primer paso: Revisar el estado del servidor de hosting

Antes de tocar nada, verifica si el problema es generalizado o solo tuyo.

Accede a tu panel de control de hosting (cPanel, Plesk, o el panel que uses, como Syspanel, cuyo acceso es a través del puerto 2106).
Busca la sección de "Estado del servidor" o "Servicios".
Comprueba que el servicio MySQL o MariaDB esté marcado como "En ejecución" o "Activo".

[INFO] Si el servicio MySQL está detenido, este es el origen del error. En tu panel de hosting, busca la opción "Reiniciar servicio" o "Iniciar MySQL". Si no puedes hacerlo, contacta con el soporte de tu proveedor y diles que el servicio MySQL está caído.

Si el servidor está activo, el problema es de configuración. Vamos a por ello.

Solucionar error MySQL en WordPress: El archivo wp-config.php

Este archivo es el corazón de la configuración de tu WordPress. Contiene las credenciales de acceso a la base de datos. Un error aquí es la causa más frecuente del problema.

Cómo acceder y editar wp-config.php

Accede a tu hosting por FTP (usando FileZilla, por ejemplo) o a través del Administrador de Archivos de tu panel de control.
Navega hasta la carpeta raíz de tu instalación de WordPress (normalmente public_html o www).
Busca el archivo wp-config.php.
Haz una copia de seguridad del archivo antes de editarlo (descárgalo a tu ordenador).

Las 4 constantes mágicas que debes revisar

Dentro del archivo, verás líneas como estas:

define( 'DB_NAME', 'tu_basededatos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Aquí es donde se esconde el 90% de los errores de conexión. Comprueba:

DB_NAME: El nombre de la base de datos debe coincidir exactamente con el que creaste en tu hosting. Un carácter mal escrito o una letra mayúscula/minúscula incorrecta romperá la conexión.
DB_USER: El usuario de la base de datos. Debe existir y tener privilegios sobre la base de datos DB_NAME.
DB_PASSWORD: La contraseña del usuario. Este es el error más común. Si has cambiado la contraseña recientemente en tu panel de hosting (por ejemplo, en Syspanel), debes actualizarla aquí. Copia y pega la contraseña directamente desde tu panel de control, no la escribas a mano para evitar errores tipográficos.
DB_HOST: Normalmente es localhost, pero en algunos hosting gestionados (como los de Syspanel) puede ser un valor diferente como mysql.syspanel.com o una IP específica. Revisa los datos de tu hosting para obtener el host correcto.

[WARNING] No uses editores de texto avanzados como Word para modificar wp-config.php, ya que pueden añadir caracteres invisibles. Usa el editor de texto plano de tu panel de control o un editor como Notepad++.

¿Y si he olvidado la contraseña de la base de datos?

No pasa nada. Puedes cambiarla desde tu panel de control de hosting.

Ve a la sección "Bases de Datos MySQL" en tu panel (cPanel, Syspanel, etc.).
Busca tu usuario de base de datos y selecciona "Cambiar contraseña".
Genera una nueva contraseña segura (o usa el generador del panel).
Actualiza el archivo wp-config.php con esta nueva contraseña.
Guarda los cambios y recarga tu web.

Errores de conexión en PrestaShop: El famoso archivo parameters.php

En PrestaShop, el mecanismo es similar pero el archivo es diferente. Se llama parameters.php y se encuentra en la carpeta app/config/.

Localizando y editando parameters.php

Accede por FTP o al Administrador de Archivos de tu hosting.
Navega a /app/config/ dentro de la raíz de tu tienda PrestaShop.
Busca el archivo parameters.php.

Este archivo contiene un array de configuración con los datos de la base de datos. Busca estas líneas:

'database_host' => 'localhost',
'database_name' => 'tu_basededatos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

La trampa de la caché de PrestaShop

Un error muy típico en PrestaShop es que, aunque hayas corregido el parameters.php, la tienda sigue mostrando el mismo error de conexión. Esto se debe a que PrestaShop guarda una caché de configuración.

[TIP] Después de editar parameters.php, borra la carpeta var/cache/ (en PrestaShop 1.7 y 1.8) o cache/ (en versiones antiguas). Puedes hacerlo desde el Administrador de Archivos de tu hosting o por FTP. No te preocupes, se regenerará automáticamente.

El error de conexión PrestaShop con "database_prefix"

A veces, el problema no es la conexión en sí, sino el prefijo de las tablas. Si tu base de datos usa un prefijo distinto al que PrestaShop espera (por ejemplo, ps_ en lugar de prestashop_), verás un error de tabla no encontrada, que es un tipo de error de conexión.

Revisa la línea 'database_prefix' => 'ps_' en parameters.php y asegúrate de que coincide con el prefijo real de tus tablas en la base de datos (puedes verlo en phpMyAdmin).

La base de datos no conecta: Problemas con el servidor MySQL y los privilegios

A veces el problema no está en los archivos de configuración, sino en el propio servidor de bases de datos o en los permisos asignados.

Verificar que el usuario tiene acceso a la base de datos

Un error típico es que el usuario de la base de datos existe, pero no tiene permisos para acceder a la base de datos específica. Esto pasa a menudo al importar una web desde otro hosting.

Entra en phpMyAdmin desde tu panel de control.
Haz clic en "Cuentas de usuario" o "Privilegios".
Busca tu usuario de base de datos y verifica que tenga marcados todos los privilegios sobre la base de datos correcta (normalmente, "Todos los privilegios").
Si no los tiene, edita los privilegios y asígnale todos los permisos sobre la base de datos de tu web.

El problema del "host" en los privilegios de MySQL

Otro error sutil es que el usuario de MySQL esté configurado para conectarse solo desde localhost, pero tu aplicación intente conectarse desde otro host (por ejemplo, 127.0.0.1 o un host remoto).

En la lista de usuarios de MySQL (en phpMyAdmin o en tu panel), asegúrate de que el usuario tenga asignado el host correcto. Si tu web se conecta a través de localhost, el usuario debe tener el host localhost en su configuración. Si usas una IP específica, debe estar permitida.

[INFO] En muchos paneles de control como Syspanel (que se accede por el puerto 2106), puedes gestionar los usuarios y sus hosts desde la sección de Bases de Datos. Busca la opción "Agregar host" o "Editar host" para tu usuario.

El servidor MySQL está sobrecargado o ha agotado las conexiones

Este es un error más avanzado, pero común en sitios con mucho tráfico. El error suele aparecer como "Too many connections".

Solución a corto plazo: Reiniciar el servicio MySQL desde tu panel de control.
Solución a largo plazo: Optimizar las consultas de tu web, usar un plugin de caché, o contactar con tu proveedor de hosting para aumentar el límite de conexiones.

Errores de conexión tras mover tu web a un nuevo hosting

Este es un clásico. Has migrado tu WordPress o PrestaShop a un nuevo servidor y ahora no conecta. Las causas son variadas:

Cambio de credenciales y de host

Al migrar, las credenciales suelen cambiar. Asegúrate de haber actualizado tanto wp-config.php como parameters.php con los nuevos datos.

El DNS todavía no se ha propagado

Si tu dominio todavía apunta al servidor antiguo, tu web intentará conectarse a una base de datos que ya no existe.

Comprueba a qué servidor apunta tu dominio con una herramienta de "DNS lookup".
Si el DNS está propagándose, espera unas horas o modifica tu archivo hosts local para forzar la vista al nuevo servidor y verificar que la web funciona correctamente.

Archivos corruptos o incompletos en la transferencia

A veces, durante la migración por FTP, algunos archivos se corrompen o no se suben completos.

[WARNING] Si has subido los archivos de tu web y el error persiste, vuelve a subir los archivos wp-config.php o parameters.php de nuevo. Asegúrate de que la transferencia se realice en modo binario (no ASCII) para evitar corrupción.

Soluciones avanzadas: Reparar la base de datos

Si los archivos de configuración son correctos y el servidor está activo, puede que la base de datos en sí esté corrupta.

Reparar la base de datos de WordPress

WordPress tiene una utilidad de reparación automática.

Añade la siguiente línea a tu archivo wp-config.php:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y visita tuweb.com/wp-admin/maint/repair.php.
Haz clic en "Reparar base de datos". WordPress intentará arreglar las tablas dañadas.
IMPORTANTE: Después de la reparación, elimina esa línea del wp-config.php por seguridad.

Reparar la base de datos de PrestaShop

PrestaShop no tiene una herramienta de reparación tan directa, pero puedes usar phpMyAdmin.

Entra en phpMyAdmin y selecciona tu base de datos.
Marca todas las tablas (clic en "Seleccionar todo").
En el menú desplegable "Con selección", elige "Reparar tabla".
Espera a que termine. Este proceso puede tardar unos minutos si la base de datos es grande.

Preguntas Frecuentes (FAQ) sobre errores de conexión a la base de datos

¿Qué hago si he cambiado la contraseña de la base de datos y ahora mi web no funciona?

Es el error más común. Simplemente edita el archivo wp-config.php (WordPress) o parameters.php (PrestaShop) y actualiza el campo DB_PASSWORD o database_password con la nueva contraseña. Recuerda borrar la caché de PrestaShop después.

¿Por qué mi base de datos no conecta si el hosting dice que MySQL está activo?

Si el servidor está activo, el problema es de credenciales, host o privilegios. Revisa los 4 puntos del archivo de configuración (nombre, usuario, contraseña, host) y verifica los privilegios del usuario en phpMyAdmin.

¿El error puede ser causado por un plugin o un tema?

Sí, aunque es menos común. Un plugin o tema mal codificado puede sobrecargar la base de datos o modificar la configuración. Para descartarlo, renombra la carpeta wp-content/plugins (en WordPress) a plugins_off y comprueba si la web carga. Si lo hace, reactiva los plugins uno a uno para encontrar el culpable.

¿Cómo sé cuál es el host de mi base de datos?

Normalmente es localhost o 127.0.0.1. Pero en hosting gestionados, puede ser un valor personalizado. Revisa los correos de bienvenida de tu proveedor de hosting o la sección de "Base de Datos" de tu panel de control (como Syspanel, que se accede por el puerto 2106). Allí suele aparecer el host de MySQL.

He probado todo y sigue sin funcionar, ¿qué más puedo hacer?

Si has verificado el estado del servidor, las credenciales, los archivos de configuración, los privilegios y has reparado la base de datos sin éxito, es hora de contactar con el soporte técnico de tu proveedor de hosting. Dales una descripción detallada de los pasos que ya has seguido. Ellos podrán revisar los logs del servidor en busca de errores más profundos.

Recuerda que este tipo de errores son frustrantes, pero casi siempre tienen una solución lógica. Siguiendo estos pasos de forma metódica, podrás resolver el error conexión base datos wordpress o el error conexión prestashop y volver a tener tu sitio operativo. La clave está en la paciencia y en revisar cada elemento uno por uno.