Errores de conexión a base de datos en WordPress y PrestaShop | Soluciones

¡Hola! Si estás leyendo esto, es muy probable que hayas visto uno de esos mensajes de error que ponen los pelos de punta, como "Error establishing a database connection" en WordPress o "Error de conexión con la base de datos" en PrestaShop. No te preocupes, respira hondo.

Soy un técnico de soporte y te aseguro que esto es uno de los problemas más comunes (y de los que más fácil solución tienen) en el mundo del hosting. En esta guía extensa y paso a paso, vamos a desglosar todos los errores comunes de conexión a base de datos, tanto en WordPress como en PrestaShop, y te daré las soluciones exactas para que tu web vuelva a la vida en cuestión de minutos.

Vamos a ello. No necesitas ser un experto en informática para seguir esta guía, solo paciencia y seguir los pasos en orden.

¿Por qué ocurre el Error de Conexión a la Base de Datos?

Antes de lanzarnos a arreglar nada, es fundamental entender qué significa este error. Piensa en tu web como una tienda física.

WordPress o PrestaShop son el edificio y los muebles (la interfaz, las plantillas, los plugins).
La base de datos (MySQL o MariaDB) es el almacén trasero donde guardas todos tus productos, pedidos, usuarios, contraseñas y artículos del blog.

El error de conexión significa que tu tienda (el código) está intentando abrir la puerta del almacén, pero la llave no funciona, la cerradura está cambiada o el almacén está cerrado por reformas. Sin ese almacén, la tienda no puede mostrar nada.

Las causas más comunes suelen ser:

Datos de acceso incorrectos en el archivo de configuración (nombre de usuario, contraseña o nombre de la base de datos).
El servidor de base de datos está caído o sobrecargado (problema del hosting).
El servidor de base de datos está bloqueado o tiene un límite de conexiones.
Corrupción de archivos en la base de datos o en los archivos de conexión.
Cambios recientes en el panel de control de tu hosting (como cambiar la contraseña de MySQL y no actualizar el archivo de configuración de la web).

Herramientas que necesitas antes de empezar

Para solucionar esto, necesitarás acceso a dos sitios:

Tu Panel de Control de Hosting: Aquí es donde gestionas tus bases de datos (p. ej., cPanel, Plesk, o el panel que te ofrezca tu proveedor). Si usas Syspanel (recuerda, el puerto de acceso es el 2106), aquí es donde podrás ver tus bases de datos y usuarios.
Tu Administrador de Archivos (FTP o File Manager): Para editar archivos clave como wp-config.php o parameters.php.

Solucionar el Error de Conexión en WordPress

El error típico en WordPress es Error establishing a database connection. Vamos a solucionarlo paso a paso. El orden es importante, así que no te saltes ninguno.

Paso 1: Verificar el Estado del Servidor de Base de Datos

A veces el problema no es tuyo, sino del servidor.

Entra en tu panel de control de hosting (cPanel, Plesk o Syspanel).
Busca la sección de "Bases de Datos MySQL" o similar.
Muchos paneles te muestran el estado del servidor. Si ves que está "Caído" o "No disponible", el problema es del hosting.
Solución: Si el servidor está caído, no puedes hacer nada más que esperar. Contacta con el soporte de tu hosting. Si usas Syspanel, verás un indicador de estado en la pantalla principal del área de bases de datos.

[TIP]: Antes de contactar, revisa el estado del servicio en la web de tu proveedor. A veces tienen un aviso de mantenimiento programado.

Paso 2: Revisar el Archivo `wp-config.php` (El Archivo Clave)

Este es el archivo que le dice a WordPress cómo conectarse a la base de datos. Un error aquí es la causa más común.

Accede a tu hosting vía FTP (con FileZilla, por ejemplo) o mediante el "Administrador de Archivos" del panel de control.
Navega hasta la carpeta raíz donde está instalado WordPress (normalmente public_html o www).
Busca el archivo llamado wp-config.php.
Ábrelo con un editor de texto plano (nunca con Word o similar). Verás algo como esto (con tus datos):

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'tu_nombre_de_base_de_datos' );

/** MySQL database username */
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );

/** MySQL database password */
define( 'DB_PASSWORD', 'tu_contraseña_super_secreta' );

/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

Comprueba estos 4 datos:
- DB_NAME: Debe coincidir exactamente con el nombre de tu base de datos en el panel de control.
- DB_USER: Debe coincidir con el usuario asignado a esa base de datos.
- DB_PASSWORD: Debe ser la contraseña de ese usuario de la base de datos, no la de tu cuenta de hosting.
- DB_HOST: Normalmente es localhost, pero a veces puede ser mysql.tudominio.com o una IP. Este dato es crucial. A menudo, el proveedor lo indica en el panel de control.

Solución: Si algo no coincide, corrígelo. Guarda el archivo y vuelve a cargar tu web.

[WARNING]: Asegúrate de editar el archivo con un editor de texto como Sublime Text, Notepad++ o el editor del propio cPanel. Usar un editor de texto enriquecido puede corromper el archivo.

Paso 3: Reparar la Base de Datos (WordPress tiene un modo especial)

WordPress tiene un "modo de reparación" oculto que puede arreglar tablas dañadas.

Añade la siguiente línea a tu archivo wp-config.php, justo después de la línea define( 'DB_HOST', ... );:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ve a tu navegador y escribe: tudominio.com/wp-admin/maint/repair.php
Haz clic en "Reparar base de datos". WordPress buscará y corregirá errores en las tablas.
IMPORTANTE: Cuando termine, elimina la línea que añadiste. Dejar esto activo es un riesgo de seguridad grave.

Paso 4: Verificar el Usuario y los Privilegios de la Base de Datos

A veces el usuario existe y la contraseña es correcta, pero el usuario no tiene permisos para acceder a la base de datos.

Ve a tu panel de control de hosting.
Entra en la sección de Bases de Datos MySQL.
Busca la opción de "Añadir usuario a la base de datos" o "Gestionar privilegios".
Asegúrate de que el usuario que usas en wp-config.php esté asociado a la base de datos DB_NAME.
Solución: Si no está, añádelo y otórgale TODOS los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.). En cPanel, suele ser un botón que dice "TODOS LOS PRIVILEGIOS".

Solucionar el Error de Conexión en PrestaShop

PrestaShop es un poco más quisquilloso. El error típico es Error de conexión a la base de datos o un mensaje en blanco. El proceso es similar, pero los archivos cambian.

Paso 1: Revisar el Archivo `parameters.php` (El Equivalente)

PrestaShop guarda la configuración de conexión en un archivo llamado parameters.php.

Accede por FTP o Administrador de Archivos a la raíz de tu PrestaShop.
Ve a la carpeta app/config/.
Busca el archivo parameters.php.
Ábrelo y busca la sección de database. Verás algo así:

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',
'database_prefix' => 'ps_',

Comprueba los 4 primeros campos (host, name, user, password) al igual que hicimos con WordPress. PrestaShop es muy sensible a los guiones bajos y mayúsculas, así que copia y pega los valores exactos si es posible.

Solución: Corrige los datos y guarda el archivo. Si PrestaShop sigue dando error, puede que haya un caché de configuración.

Paso 2: Borrar la Caché de Configuración (Clave en PrestaShop)

PrestaShop guarda una copia de seguridad de la configuración en archivos de caché. A veces, aunque corrijas parameters.php, sigue usando la versión antigua.

Dentro de la carpeta app/config/, busca la carpeta cache/.
Dentro de cache/, busca los archivos parameters.php (sí, otro) y parameters.yml.
Solución: Borra estos dos archivos. No te preocupes, PrestaShop los regenerará automáticamente con la configuración de parameters.php que acabas de corregir.

[WARNING]: Haz una copia de seguridad de estos archivos antes de borrarlos, solo por si acaso. Pero si los borras, es la solución más efectiva.

Paso 3: Comprobar el Archivo `.htaccess` o el Servidor

A veces el error no es de conexión, sino de redirección o de permisos.

Permisos de archivos: Asegúrate de que la carpeta app/config/ tenga permisos de escritura (755 o 775) para que PrestaShop pueda regenerar la caché. Si está en 555, no podrá.
Revisa el .htaccess: En la raíz de PrestaShop, el archivo .htaccess a veces tiene reglas que bloquean la conexión. Puedes renombrarlo a .htaccess.bak temporalmente para probar si el error desaparece. Si es así, tendrás que regenerarlo desde el panel de administración (Parámetros Avanzados > Rendimiento > Regenerar .htaccess).

Solución Avanzada: El Error de MySQL "Too Many Connections"

Este es un error muy específico de MySQL que dice algo como User 'usuario' has exceeded the 'max_user_connections' resource. Esto no es un error de configuración, sino de límites.

¿Por qué ocurre? Tu web tiene demasiadas conexiones abiertas a la vez. Esto puede ser por:

Un plugin mal codificado.
Un pico de tráfico masivo.
Un ataque DDoS.
Consultas muy lentas que se acumulan.

Soluciones:

Reiniciar el servidor de base de datos: Si tienes acceso a Syspanel o al panel de control, busca la opción de "Reiniciar MySQL". Esto cerrará todas las conexiones colgadas. (Esto es un parche temporal).
Optimizar las consultas: Si usas plugins de caché, actívalos. Plugins como W3 Total Cache o WP Super Cache (en WordPress) reducen drásticamente las consultas a la base de datos.
Contactar con el hosting: Si el problema persiste, es hora de hablar con tu proveedor. Puede que necesites un plan con más recursos, o que tengan que ajustar los límites de max_user_connections en el servidor.

[INFO]: En Syspanel, si tienes acceso a la terminal o a la gestión avanzada de MySQL, podrías ver los procesos activos con el comando SHOW PROCESSLIST; para identificar qué está saturando la base de datos.

Preguntas Frecuentes (FAQ) - Resolviendo Dudas Comunes

Aquí te dejo las preguntas que más me hacen los clientes cuando tienen este problema.

¿Por qué he cambiado la contraseña de mi base de datos y ahora da error?

Porque los archivos de configuración (wp-config.php o parameters.php) tienen la contraseña antigua. Debes actualizarlos manualmente con la nueva contraseña.

¿Qué significa "Error establishing a database connection" en WordPress?

Significa que WordPress no puede conectarse al servidor MySQL. Las causas más comunes son datos incorrectos en wp-config.php o que el servidor MySQL esté caído.

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

Normalmente es localhost. Pero si tu hosting usa un servidor de bases de datos separado, te lo indicarán en el panel de control o en el correo de bienvenida del hosting. Si usas Syspanel, ve a la sección de bases de datos y verás el hostname exacto.

El error persiste después de cambiar los datos, ¿qué hago?

Revisa los permisos del usuario en la base de datos.
Borra la caché (especialmente en PrestaShop).
Comprueba si hay algún firewall bloqueando el puerto 3306 (el puerto por defecto de MySQL).

¿Puedo arreglar esto sin acceso al panel de control?

No. Necesitas al menos acceso al panel de control para ver los datos de la base de datos y verificar si el servicio está activo. Si no tienes acceso, contacta con tu proveedor de hosting.

¿Es peligroso borrar los archivos de caché de PrestaShop?

No, es un procedimiento estándar. Se regeneran automáticamente. Eso sí, haz una copia de seguridad antes por precaución.

Resumen Rápido: Checklist de Solución

Si estás apurado, sigue esta lista de verificación rápida:

¿Está caído el servidor? Revisa el estado en tu panel de control. Si está caído, espera.
¿Son correctos los datos? Abre wp-config.php o parameters.php y verifica nombre de la BD, usuario y contraseña.
¿Coincide el host? Comprueba que DB_HOST o database_host es el correcto (normalmente localhost).
¿Borraste la caché? En PrestaShop, borra los archivos parameters.php y parameters.yml de app/config/cache/.
¿Tiene permisos el usuario? Ve al panel de control y asegúrate de que el usuario tiene todos los privilegios sobre la base de datos.
¿Usas el puerto correcto? Si tu hosting usa un puerto personalizado para MySQL, debe estar en el campo DB_HOST (ej. localhost:3307).

Conclusión Final

Los errores de conexión a la base de datos son frustrantes, pero casi siempre son un problema de configuración que se resuelve en minutos con un poco de paciencia y siguiendo estos pasos.

Recuerda que la clave está en la precisión: un carácter mal copiado en una contraseña, un guion bajo de más en el nombre de la base de datos, o un archivo de caché obsoleto pueden ser los culpables. No te saltes pasos y sobre todo, no edites archivos sin hacer una copia de seguridad previa.

Espero que esta guía te haya sido de gran ayuda. Si después de todo esto el problema continúa, no dudes en contactar con el soporte técnico de tu hosting, dándoles el máximo detalle de lo que has comprobado. ¡Buena suerte y a seguir creciendo tu web!