Errores de Conexión a Base de Datos | Soluciones 2024

Primeros pasos: entender por qué falla la conexión

Cuando tu tienda online o tu blog dejan de funcionar de repente, el primer sospechoso suele ser la base de datos. Y no es para menos: tanto WordPress como PrestaShop dependen completamente de ella para mostrar páginas, gestionar productos y guardar usuarios.

Lo primero que debes saber es que un error de conexión no significa que hayas perdido tus datos. En el 90% de los casos es un problema de configuración, permisos o un servicio caído. Así que respira hondo y vamos a solucionarlo paso a paso.

¿Cómo saber si realmente es un problema de base de datos?

Antes de tocar nada, identifica el síntoma exacto. Los errores más comunes son:

En WordPress: "Error establishing database connection" (Error al establecer la conexión con la base de datos).
En PrestaShop: "Error de conexión a la base de datos" o un mensaje similar en blanco.
En ambos: Páginas que cargan a medias, o un mensaje tipo "MySQL cannot connect".

Si ves alguno de estos mensajes, estás en el lugar correcto. Vamos a desglosar las causas más frecuentes y cómo resolverlas sin volverte loco.

Error 1: El clásico "error establishing database connection" en WordPress

Este es, sin duda, el error más famoso del mundo WordPress. Aparece cuando tu sitio no puede comunicarse con el servidor de base de datos. Las causas suelen ser muy concretas.

Causa A: Datos de acceso incorrectos en el archivo wp-config.php

El archivo wp-config.php contiene las credenciales de acceso a tu base de datos. Si estos datos son erróneos, WordPress no puede conectar.

Cómo solucionarlo:

Accede a tu hosting mediante FTP o el administrador de archivos de tu panel (Syspanel, si usas HestiaCP, recuerda que el puerto de acceso es el 2106).
Busca el archivo wp-config.php en la raíz de tu instalación de WordPress.
Ábrelo con un editor de texto y localiza estas líneas:

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

Verifica que estos datos coinciden exactamente con los que te proporcionó tu proveedor de hosting. Un error típico es cambiar la contraseña de la base de datos desde el panel y olvidar actualizarla en este archivo.

[TIP] Si no recuerdas tus credenciales, entra en Syspanel (puerto 2106) y busca la sección de bases de datos. Allí podrás ver el nombre exacto, el usuario y restablecer la contraseña.

Causa B: El servidor de base de datos está caído o saturado

A veces el problema no es tuyo, sino del servidor. Si el servicio MySQL o MariaDB se ha detenido, nadie puede conectar.

Cómo solucionarlo:

Entra en tu panel de control (por ejemplo, Syspanel).
Busca la sección de "Servicios" o "Estado del servidor".
Localiza MySQL o MariaDB y comprueba si está activo.
Si está detenido, haz clic en "Iniciar" o "Reiniciar".

[WARNING] Si el servidor se cae con frecuencia, puede ser un síntoma de que tu web está consumiendo demasiados recursos. Considera optimizar las consultas o contratar un plan superior.

Causa C: El host de la base de datos no es "localhost"

En muchos hostings compartidos, la base de datos está en un servidor distinto al de tu web. En ese caso, el DB_HOST no será localhost, sino algo como mysql.tudominio.com o una IP específica.

Cómo solucionarlo:

Revisa la información de bienvenida de tu hosting o el panel de administración.
Actualiza el valor de DB_HOST en el wp-config.php con el host correcto.

[INFO] Si acabas de migrar tu web a un nuevo hosting, este es el error más habitual. Siempre revisa el host antes de tocar nada más.

Error 2: "MySQL cannot connect" en PrestaShop

PrestaShop es un poco más quisquilloso con las conexiones a base de datos. El error suele manifestarse con una pantalla en blanco o un mensaje de error crítico.

Causa A: El archivo settings.inc.php tiene datos obsoletos

En PrestaShop, la configuración de la base de datos se guarda en el archivo app/config/parameters.php (en versiones 1.7 y superiores) o en config/settings.inc.php (en versiones 1.6 y anteriores).

Cómo solucionarlo:

Accede a tu hosting por FTP o administrador de archivos.
Localiza el archivo correspondiente según tu versión.
Busca las líneas que definen los parámetros de conexión:

'database_host' => 'localhost',
'database_name' => 'tu_base',
'database_user' => 'tu_usuario',
'database_password' => 'tu_clave',

Corrige los valores si son incorrectos.

[WARNING] En versiones 1.6, el archivo settings.inc.php es muy sensible. Haz una copia de seguridad antes de modificarlo.

Causa B: Problemas con los permisos del usuario de la base de datos

A veces los datos son correctos, pero el usuario de la base de datos no tiene permisos suficientes para conectarse desde el servidor donde está tu tienda.

Cómo solucionarlo:

Entra en Syspanel (puerto 2106) y ve a la sección de bases de datos.
Localiza tu base de datos y haz clic en "Gestionar permisos" o similar.
Asegúrate de que tu usuario tiene todos los privilegios sobre la base de datos, especialmente SELECT, INSERT, UPDATE y DELETE.
Si el usuario no aparece, añádelo y asígnale todos los permisos.

[TIP] Algunos paneles te permiten elegir "Todos los privilegios" con una sola casilla. Es la opción más segura para evitar problemas.

Causa C: El prefijo de las tablas no coincide

PrestaShop usa un prefijo para sus tablas, normalmente ps_. Si has importado una base de datos de otro sitio con un prefijo distinto, la conexión fallará.

Cómo solucionarlo:

Abre tu gestor de base de datos (phpMyAdmin, por ejemplo).
Revisa el nombre real de las tablas. Deberían llamarse ps_products, ps_orders, etc.
Si el prefijo es diferente, actualiza el archivo parameters.php o settings.inc.php con el prefijo correcto (línea 'database_prefix' => 'tu_prefijo_').

Error 3: El puerto de conexión es incorrecto

En ocasiones, el servidor de base de datos no escucha en el puerto estándar 3306. Esto puede pasar si has cambiado la configuración de tu servidor o si tu hosting usa un puerto personalizado.

Cómo solucionarlo:

Añade el puerto al host en tu archivo de configuración. Por ejemplo: localhost:3307 en lugar de solo localhost.

[INFO] Si usas Syspanel, revisa la configuración del servicio MySQL para ver el puerto exacto. Suele estar en la sección de servicios.

Error 4: Base de datos corrupta o con tablas dañadas

A veces la conexión funciona, pero la base de datos está corrupta y la web se cae. Esto puede ocurrir tras una caída del servidor o una importación fallida.

Cómo solucionarlo:

Entra en phpMyAdmin (desde Syspanel, puerto 2106, sección de bases de datos).
Selecciona tu base de datos.
Marca todas las tablas y en el menú desplegable elige "Reparar tabla".

Esto suele arreglar tablas dañadas sin tocar tus datos.

[WARNING] Si la reparación no funciona, prueba a restaurar una copia de seguridad reciente. Por eso siempre es vital tener backups automáticos.

Error 5: Conflictos tras migrar de hosting o dominio

Migrar una web es una operación delicada. Es muy fácil que se queden datos antiguos que apunten al servidor anterior.

Cómo solucionarlo:

Revisa que el archivo de configuración apunta al nuevo servidor y no al antiguo.
Si has cambiado de dominio, verifica que no hay URLs antiguas en la base de datos (aunque esto no impide la conexión, puede causar problemas de rendimiento).
Si usas Syspanel, asegúrate de que la base de datos se ha importado correctamente en el nuevo servidor.

[TIP] Después de migrar, siempre prueba a conectar primero con las credenciales nuevas en un cliente MySQL como HeidiSQL o MySQL Workbench antes de tocar tu web.

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

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

No hay problema. Entra en Syspanel (puerto 2106), localiza tu base de datos y restablece la contraseña. Luego actualiza el archivo de configuración de tu web con la nueva clave.

¿Puedo cambiar el usuario de la base de datos?

Sí, pero debes asegurarte de que el nuevo usuario tiene todos los privilegios sobre la base de datos. Hazlo desde el panel de control y luego actualiza los archivos de configuración.

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

Esto suele indicar que el servidor de base de datos está saturado o que hay límites de conexiones activas. Si usas un hosting compartido, es posible que otros sitios estén consumiendo muchos recursos. Contacta con tu proveedor si es recurrente.

¿Qué es exactamente "MySQL cannot connect"?

Es un mensaje genérico que indica que la aplicación no puede establecer una conexión con el servidor MySQL. Puede deberse a cualquiera de los errores que hemos visto: credenciales, host, puerto, permisos o servidor caído.

¿Pierdo mis datos si borro la base de datos?

Sí, absolutamente. Nunca borres una base de datos sin tener una copia de seguridad actualizada. Si tienes dudas, contacta con soporte antes de tomar medidas drásticas.

Consejos finales para evitar futuros errores

Haz copias de seguridad periódicas: Tanto de la base de datos como de los archivos. Es tu red de seguridad.
Anota tus credenciales en un lugar seguro: Guarda el nombre de la base de datos, usuario y contraseña en un gestor de contraseñas.
Usa contraseñas robustas: Evita claves como "admin123". Una contraseña débil puede provocar ataques que corrompan tu base de datos.
Mantén tu CMS actualizado: Tanto WordPress como PrestaShop lanzan actualizaciones de seguridad que previenen problemas.

[INFO] Si usas Syspanel, activa las copias de seguridad automáticas. Es una opción muy recomendable que te puede salvar de más de un susto.

Resumen rápido: checklist para solucionar errores de conexión

Verifica las credenciales en tu archivo de configuración.
Comprueba que el servicio MySQL está activo en tu panel.
Revisa el host y el puerto de conexión.
Asegúrate de que el usuario tiene permisos sobre la base de datos.
Comprueba el prefijo de las tablas (especialmente en PrestaShop).
Repara las tablas desde phpMyAdmin si sospechas corrupción.
Si nada funciona, restaura una copia de seguridad reciente.

Con esta guía, deberías poder resolver la mayoría de los errores de conexión a base de datos en WordPress y PrestaShop. Recuerda que la calma es tu mejor aliada: casi todos los problemas tienen solución y, en el peor de los casos, siempre puedes pedir ayuda a tu proveedor de hosting o a un técnico especializado.