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

Conectar una base de datos es el corazón de cualquier tienda online o blog. Tanto WordPress como PrestaShop dependen completamente de MySQL o MariaDB para almacenar productos, usuarios, pedidos y configuraciones.

Cuando esa conexión falla, el resultado es inmediato: tu web muestra un mensaje de error crítico, se bloquea el panel de administración o, en el peor de los casos, aparece la temida pantalla blanca o un error 500 base de datos.

No te preocupes. En esta guía extensa vamos a desglosar, paso a paso y sin tecnicismos innecesarios, los errores más comunes al conectar a una base de datos, tanto en WordPress como en PrestaShop. Aprenderás a diagnosticarlos y solucionarlos tú mismo, incluso si nunca has tocado un archivo de configuración.

Antes de empezar: ¿Qué significa "conectar a la base de datos"?

Imagina que tu web es una tienda física. El edificio es el servidor, los estantes son los archivos de WordPress o PrestaShop, y la trastienda donde guardas el inventario es la base de datos. Para vender (mostrar la web), necesitas abrir la puerta de la trastienda con la llave correcta.

Esa "llave" son los datos de acceso: nombre de la base de datos, usuario, contraseña, host (servidor) y puerto. Si alguno de estos datos es incorrecto, o si la "puerta" (el servidor MySQL) está cerrada o rota, la conexión falla.

Error 1: Credenciales incorrectas (El clásico "Error al conectar con la base de datos")

Este es, con diferencia, el error más habitual. WordPress te muestra el mensaje: "Error al establecer una conexión con la base de datos". PrestaShop, por su parte, suele mostrar un mensaje similar durante la instalación o un error directo en la tienda.

¿Por qué ocurre?

La causa principal es que los datos guardados en tu archivo de configuración no coinciden con los datos reales de tu servidor de base de datos. Esto puede pasar después de:

Migrar la web a un nuevo hosting.
Cambiar la contraseña de MySQL desde el panel de control (como cPanel o Syspanel).
Restaurar una copia de seguridad en un servidor diferente.

Cómo solucionarlo en WordPress

Accede a tu panel de control de hosting o a través de FTP (FileZilla).
Busca el archivo llamado wp-config.php en la raíz de tu instalación.
Ábrelo con un editor de texto (como Bloc de notas o Sublime Text).
Busca las líneas que definen las constantes:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Verifica cuidadosamente que estos datos son correctos. Un simple espacio extra al final de la contraseña o un carácter mal copiado es suficiente para romper la conexión.
Si no estás seguro de la contraseña, cámbiala desde el panel de tu hosting (por ejemplo, en Syspanel, que se accede a través del puerto 2106, busca la sección de Bases de Datos MySQL) y actualiza el archivo con la nueva.

Cómo solucionarlo en PrestaShop

PrestaShop guarda esta información en el archivo app/config/parameters.php.

Localiza el archivo en tu servidor.
Ábrelo y busca el bloque database_host, database_name, database_user y database_password.
Corrige los valores incorrectos.

[TIP]
Si acabas de migrar de hosting, asegúrate de que el database_host no sea localhost. A menudo es un host remoto como mysql.tudominio.com o una IP específica. Consulta la documentación de tu nuevo proveedor.

Error 2: El servidor MySQL no está disponible o está caído

A veces el problema no son tus datos, sino que el servidor que aloja la base de datos está apagado, sobrecargado o reiniciándose.

Síntomas

En WordPress: "Error al establecer una conexión con la base de datos".
En PrestaShop: "Cannot connect to the database" o un error 500 base de datos.
La web tarda mucho en cargar y luego muestra el error.

Diagnóstico y solución

Comprueba el estado del servicio MySQL desde tu panel de control de hosting. En Syspanel (puerto 2106), busca la sección "Servicios" o "Gestión de servicios" y verifica que MySQL/MariaDB esté en estado "Running".
Si está apagado, intenta iniciarlo manualmente.
Si no tienes acceso a esa opción, contacta con tu proveedor de hosting. Puede ser un problema temporal del servidor compartido.

[WARNING]
Si el servidor MySQL se cae repetidamente, puede ser un síntoma de que tu web está siendo atacada o de que una consulta está sobrecargando el sistema. Si no es un problema puntual, revisa los plugins o módulos que tengas instalados.

Error 3: El usuario no tiene permisos sobre la base de datos

En MySQL, no basta con tener un usuario y una contraseña. Ese usuario debe tener privilegios específicos sobre la base de datos concreta (SELECT, INSERT, UPDATE, DELETE, etc.). Si los permisos se han configurado mal, la conexión se rechaza.

Cómo detectarlo

El mensaje de error suele ser más específico: "Access denied for user 'tu_usuario'@'localhost'".
Ocurre a menudo al importar una base de datos a un nuevo hosting donde el usuario no fue vinculado correctamente.

La solución (a través de cPanel o Syspanel)

Accede a tu panel de control (por ejemplo, Syspanel, puerto 2106).
Ve a la sección de Bases de Datos MySQL.
Busca la opción "Añadir usuario a la base de datos" o "Gestionar privilegios".
Asegúrate de que el usuario que usas en wp-config.php o parameters.php esté asignado a la base de datos correcta.
Marca la casilla de "Todos los privilegios" (ALL PRIVILEGES) para evitar problemas futuros.

[INFO]
Siempre es buena práctica usar un usuario específico para la base de datos de tu web, en lugar del usuario "root". Esto limita el daño si la web es comprometida.

Error 4: El host de la base de datos es incorrecto (más común de lo que crees)

Cuando instalas WordPress o PrestaShop en un hosting normal, el host suele ser localhost. Pero en configuraciones más avanzadas (servidores cloud, hosting con MySQL separado), el host es una URL o IP distinta.

El problema

En WordPress: DB_HOST está configurado como localhost pero el servidor MySQL está en otro lugar.
En PrestaShop: database_host apunta a un dominio que ya no existe.

Troubleshooting MySQL: Cómo encontrarlo

Revisa el correo de bienvenida de tu hosting. Suele incluir el nombre del servidor MySQL (ej. mysql.tudominio.com).
Si usas Syspanel, el panel te mostrará el host exacto en la sección "Bases de datos", junto al nombre de la base de datos.
Prueba a cambiar localhost por 127.0.0.1 (a veces funciona si hay un problema de resolución de nombres).

Error 5: Error 500 base de datos por incompatibilidad de versiones

Si has restaurado una copia de seguridad de un sitio antiguo en un servidor con una versión de MySQL más nueva (o viceversa), puedes encontrarte con un error 500 base de datos o un error de "formato de tabla no compatible".

Causa

Las tablas de la base de datos usan un motor (como MyISAM) que ya no es compatible.
La codificación de caracteres (collation) es diferente.

Solución

Accede a phpMyAdmin (desde Syspanel o cPanel).
Selecciona tu base de datos.
Haz clic en la pestaña "Exportar" para hacer una copia de seguridad (por seguridad).
Ve a la pestaña "Operaciones" o "SQL" y ejecuta el siguiente comando para convertir todas las tablas al motor InnoDB (el más estándar):

ALTER TABLE tu_tabla ENGINE=InnoDB;

Repite el comando para cada tabla, o busca la opción "Convertir todas las tablas" en la interfaz.

[WARNING]
Haz siempre una copia de seguridad antes de ejecutar comandos SQL manuales. Un error puede corromper los datos.

Error 6: Archivos de configuración con permisos incorrectos

Tanto wp-config.php como parameters.php son archivos sensibles. Si tienen permisos demasiado abiertos (por ejemplo, 777), el servidor puede bloquear su lectura por seguridad, o peor, un atacante podría leerlos.

El error

No es un error directo de conexión, sino un problema de seguridad que puede derivar en uno.
WordPress a veces muestra un aviso de "permisos de archivo inseguros".

La solución

Usa un cliente FTP (FileZilla) o el administrador de archivos de tu hosting.
Cambia los permisos del archivo wp-config.php a 644.
Para parameters.php en PrestaShop, usa permisos 644 también.

Error 7: El puerto de conexión no es el estándar (3306)

Por defecto, MySQL usa el puerto 3306. Sin embargo, algunos proveedores de hosting usan puertos alternativos por seguridad.

Dónde configurarlo

En WordPress, dentro de wp-config.php, añade una línea extra después de DB_HOST:

define('DB_HOST', 'localhost:3307');

Cambia el 3307 por el puerto que te indique tu hosting.

En PrestaShop, el archivo parameters.php tiene una entrada database_port. Si no existe, puedes añadirla.

Error 8: La base de datos no existe o está vacía

Este error es muy común cuando se restaura una copia de seguridad mal hecha.

Síntoma

WordPress muestra: "Unknown database 'nombre_base'".
PrestaShop dice: "Base de datos no encontrada".

Solución

Ve a tu panel de control (Syspanel, puerto 2106).
Entra en phpMyAdmin.
Mira en el listado de la izquierda si aparece tu base de datos.
Si no aparece, créala con el nombre exacto que figura en tu archivo de configuración.
Si aparece pero está vacía, importa tu archivo .sql de respaldo desde la pestaña "Importar".

Error 9: Problemas con la caché de WordPress o PrestaShop

A veces, el error de conexión es fantasma. La base de datos funciona, pero la caché guarda un error previo.

Cómo forzar la limpieza

En WordPress, renombra la carpeta wp-content/cache a cache_old. Esto fuerza a WordPress a crear una nueva.
En PrestaShop, borra el contenido de las carpetas var/cache/prod y var/cache/dev.

[TIP]
Si no tienes acceso FTP, puedes usar un script PHP temporal para limpiar la caché, pero es más seguro hacerlo por FTP.

Error 10: Conflictos con plugins o módulos de caché (Redis, Memcached)

Si usas un plugin de caché avanzado (como Redis Object Cache), y el servidor Redis no está configurado, puede bloquear la conexión a MySQL.

La solución rápida

Desactiva el plugin de caché renombrando su carpeta en wp-content/plugins/.
Si el error desaparece, el problema es la configuración de Redis/Memcached, no MySQL.

Guía rápida de troubleshooting mysql (Checklist final)

Si llegaste hasta aquí y sigues con el problema, sigue esta lista mental:

Respira: No es un problema de hardware, se puede arreglar.
Revisa el panel de control: ¿Está MySQL activo? (En Syspanel, puerto 2106, sección "Servicios").
Verifica los datos: ¿Son correctos el nombre, usuario y contraseña? (Pruébalos en phpMyAdmin).
Comprueba los permisos: ¿El usuario tiene acceso a la base de datos?
Prueba el host: Cambia localhost por 127.0.0.1 o el host remoto que te den.
Mira los logs de error: En cPanel busca "Error Logs" o en Syspanel la sección de logs. Ahí verás el error exacto de MySQL.

Preguntas Frecuentes (FAQ) sobre errores de conexión

¿Por qué me sale "Error al conectar con la base de datos" después de cambiar la contraseña de MySQL?

Porque el archivo wp-config.php (o parameters.php) aún tiene la contraseña antigua. Debes actualizarlo manualmente con la nueva contraseña.

¿Qué es ese puerto 2106 que mencionas?

Es el puerto de acceso al panel de control Syspanel (el antiguo HestiaCP). Para gestionar tus bases de datos, servicios y archivos, escribe https://tudominio.com:2106 en tu navegador.

¿Puede un plugin de seguridad bloquear la conexión a la base de datos?

Sí. Algunos plugins de seguridad (como Wordfence) pueden bloquear IPs o intentos de conexión, pero es raro que bloqueen la conexión de la propia web a MySQL. Si lo sospechas, desactiva el plugin renombrando su carpeta.

El error 500 base de datos, ¿siempre es culpa de MySQL?

No. Un error 500 base de datos en PrestaShop o WordPress puede ser causado por un error de PHP, un problema de memoria o un archivo .htaccess corrupto. Si el mensaje no menciona "base de datos", revisa primero los logs de PHP.

¿Debo usar el usuario "root" para mi web?

Nunca. Usa un usuario específico con permisos limitados a tu base de datos. Es una práctica de seguridad básica.

Conclusión

Los errores de conexión a la base de datos son frustrantes, pero en el 90% de los casos se reducen a un problema de datos incorrectos o permisos mal configurados. Siguiendo esta guía, ya tienes el conocimiento para enfrentarte a ellos con confianza.

Recuerda: antes de tocar nada, haz una copia de seguridad de tu base de datos y de tus archivos de configuración. La prevención es tu mejor aliada.

Si después de todo esto el problema persiste, no dudes en contactar con tu soporte técnico de hosting. Diles que ya has revisado los puntos de esta lista; te lo agradecerán y te ayudarán mucho más rápido.