🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Errores comunes al conectar la base de datos y cómo solucionarlos (WordPress, PrestaShop)

Actualizado el 5 de mayo de 2026

El temido error de conexión a la base de datos: ¿Qué significa realmente?

Cuando tu web de WordPress o PrestaShop se queda en blanco o muestra un mensaje de error sobre la base de datos, el corazón se te acelera. Es como si el motor de tu coche se parara en mitad de la autopista. Pero respira hondo, porque en la gran mayoría de los casos, este problema tiene una solución clara y paso a paso que puedes seguir sin ser un experto en programación.

La base de datos es el almacén donde tu web guarda todos sus secretos: artículos, productos, pedidos, usuarios, contraseñas cifradas y configuración. Si tu web no puede "hablar" con ese almacén, simplemente no puede funcionar. Los errores más comunes al conectar la base de datos suelen deberse a tres grandes causas: datos de acceso incorrectos, el servidor de base de datos caído o saturado, y problemas de permisos o configuración de archivos.

En esta guía, vamos a desglosar cada uno de estos escenarios, tanto para WordPress como para PrestaShop, y te daré soluciones prácticas y fáciles de aplicar. Al final, te sentirás con el poder de diagnosticar y arreglar el problema tú mismo, o al menos, de hablar con tu proveedor de hosting con conocimiento de causa.

Configuración de la base de datos: El punto de partida

Antes de lanzarnos a las soluciones, es fundamental que entiendas dónde se guardan estos "datos de acceso". Cada sistema tiene su propio archivo de configuración.

Localizando el archivo en WordPress: wp-config.php

En WordPress, toda la información de conexión se encuentra en el archivo wp-config.php, que está en la raíz de tu instalación. Es el archivo más importante después de los que contienen el núcleo. Para encontrarlo, necesitas acceder a tu hosting mediante FTP (como FileZilla) o el administrador de archivos de tu panel de control (cPanel, Syspanel, etc.).

Dentro de este 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' );

Estos cuatro valores son la clave. Cualquier error aquí, y tendrás el famoso wordpress error base de datos.

Localizando el archivo en PrestaShop: parameters.php

En PrestaShop, la configuración se divide en dos archivos dentro de la carpeta app/config/. El principal es parameters.php. Es un archivo que contiene un array con los mismos datos: database_host, database_name, database_user y database_password.

Error de conexión: Los sospechosos habituales (y sus soluciones)

Ahora sí, vamos a lo que importa. Aquí tienes los errores más comunes y cómo solucionarlos.

1. "Error al establecer una conexión con la base de datos" (WordPress) o "Cannot connect to DB" (PrestaShop)

Este es el error genérico. Significa que WordPress o PrestaShop no pueden ni siquiera iniciar una conversación con el servidor de base de datos. Las causas más frecuentes son:

Datos de acceso incorrectos

El problema: Es el error más básico. Has cambiado la contraseña de la base de datos, has migrado el sitio a un nuevo hosting y no has actualizado el archivo, o simplemente te has equivocado al escribir.

La solución:

  1. Accede a tu panel de control de hosting. Busca la sección de "Bases de Datos MySQL".
  2. Verifica los nombres de usuario y contraseñas. Asegúrate de que la contraseña no tenga espacios extra y que el nombre de la base de datos y el usuario sean exactamente como aparecen en tu panel.
  3. Edita el archivo de configuración:
    • Para WordPress: Abre wp-config.php y corrige los valores de DB_NAME, DB_USER y DB_PASSWORD.
    • Para PrestaShop: Abre app/config/parameters.php y corrige los valores de database_name, database_user y database_password.
  4. Guarda los cambios y sube el archivo de nuevo si lo has editado localmente.

[TIP] Si has cambiado la contraseña de la base de datos desde tu panel de control, recuerda que también debes actualizarla en el archivo de configuración. Es el error más común después de un cambio de este tipo.

El servidor de base de datos está caído o reiniciándose

El problema: A veces, el problema no eres tú, sino el servidor donde vive tu base de datos. Esto puede ocurrir durante un mantenimiento programado, una sobrecarga del servidor o un fallo técnico.

La solución:

  1. Espera unos minutos. A veces es un reinicio rápido.
  2. Revisa el estado del servicio en tu hosting. Muchos paneles (como cPanel o Syspanel) tienen una sección de "Estado del Servidor" donde puedes ver si el servicio MySQL/MariaDB está activo.
  3. Si todo parece caído, contacta con tu proveedor de hosting. Ellos son los únicos que pueden reiniciar el servicio a nivel de servidor.

[WARNING] Si tienes acceso a Syspanel (el panel de control que usa HestiaCP, accesible a través del puerto 2106), puedes intentar reiniciar el servicio MySQL desde la sección de "Servicios". Pero ten cuidado, si no sabes lo que haces, es mejor contactar con soporte.

2. "Too many connections" (Demasiadas conexiones)

Este es un error clásico y muy frustrante: too many connections mysql. Aparece cuando el número de conexiones simultáneas a tu base de datos supera el límite permitido por el servidor.

El problema: Imagina que tu base de datos es un restaurante con un número limitado de mesas. Si llegan más clientes (conexiones) que mesas, los que esperan fuera reciben un aviso. Este error puede ser causado por:

  • Un plugin o módulo mal configurado que abre muchas conexiones sin cerrarlas.
  • Un pico de tráfico muy alto en tu web.
  • Consultas muy lentas que mantienen las conexiones ocupadas durante mucho tiempo.
  • El límite del servidor es muy bajo para las necesidades de tu web.

La solución:

  1. Reinicia el servicio de base de datos. Esto cierra todas las conexiones colgadas de golpe. Puedes hacerlo desde tu panel de control (Syspanel, en el puerto 2106) o contactando con tu hosting. Es una solución rápida y temporal.
  2. Identifica al culpable. Revisa los plugins o módulos que hayas instalado recientemente. Desactívalos uno a uno para ver si el error desaparece.
  3. Optimiza las consultas. Si tienes conocimientos técnicos, revisa si hay consultas lentas en los logs de MySQL. Un desarrollador puede ayudarte a optimizarlas.
  4. Aumenta el límite de conexiones. Si tienes un VPS o servidor dedicado, puedes aumentar el valor max_connections en el archivo de configuración de MySQL (my.cnf o my.ini). Si estás en hosting compartido, esta opción no está disponible y tendrás que hablar con tu proveedor.

[INFO] El error "Too many connections" es un síntoma, no la enfermedad. Solucionarlo definitivamente requiere encontrar la causa raíz, que suele ser un plugin o un pico de tráfico.

Soluciones avanzadas y específicas por plataforma

A veces, el problema es más profundo que un simple cambio de contraseña. Vamos a explorar otros escenarios.

3. El host de la base de datos no es "localhost"

El problema: Muchas veces, el error se debe a que el host de la base de datos no es localhost. En entornos de hosting compartido, el servidor de base de datos a menudo tiene un nombre de host específico (ej. mysql.tudominio.com). Usar localhost cuando no corresponde es un error muy común.

La solución:

  • Consulta la documentación de tu hosting o el correo de bienvenida. Busca la sección de "Bases de datos" y verás el nombre del servidor MySQL.
  • Actualiza el archivo de configuración:
    • En WordPress, cambia el valor de DB_HOST.
    • En PrestaShop, cambia el valor de database_host en parameters.php.

4. Errores de permisos y prefijos de tabla

El problema: En ocasiones, el usuario de la base de datos no tiene todos los permisos necesarios (SELECT, INSERT, UPDATE, DELETE, etc.) sobre las tablas. O bien, el prefijo de las tablas en la base de datos no coincide con el que espera el script.

La solución:

  1. Verifica los permisos del usuario. Desde tu panel de control, edita el usuario de la base de datos y asegúrate de que tenga "Todos los privilegios" sobre la base de datos en cuestión.
  2. Comprueba el prefijo de las tablas.
    • En WordPress, el prefijo por defecto es wp_. Puedes verlo en $table_prefix en wp-config.php.
    • En PrestaShop, el prefijo por defecto es ps_. Puedes verlo en parameters.php como database_prefix.
    • Accede a tu base de datos con phpMyAdmin y verifica que las tablas tengan el mismo prefijo. Si no es así, tendrás que actualizar el archivo de configuración o renombrar las tablas (¡cuidado con esto último!).

5. El puerto de conexión a la base de datos

El problema: Aunque es menos común, a veces el servidor de base de datos no está en el puerto estándar (3306) y necesita un puerto específico.

La solución:

  • Añade el puerto al host. En WordPress, si tu host es mysql.example.com y el puerto es 3307, deberías escribir mysql.example.com:3307 en DB_HOST.
  • En PrestaShop, existe un parámetro separado, database_port, que puedes añadir al archivo parameters.php.

PrestaShop: El error específico de su caché

PrestaShop tiene un sistema de caché muy agresivo. A veces, después de un cambio en la configuración de la base de datos o del servidor, la caché guarda los datos antiguos y sigue mostrando el error.

La solución:

  1. Borra la caché manualmente.
    • Accede por FTP a tu instalación de PrestaShop.
    • Borra el contenido de las carpetas var/cache/dev y var/cache/prod (en versiones antiguas, la carpeta cache).
  2. Desactiva la caché desde el archivo de configuración. En app/config/parameters.php, busca 'cache_enabled' => true y cámbialo a false. Esto es una solución temporal para que puedas acceder al panel de administración y arreglar el problema desde allí.

Cómo prevenir futuros errores de conexión

Una vez que hayas solucionado el problema, es hora de blindar tu web para que no vuelva a ocurrir.

  • Mantén todo actualizado: WordPress, PrestaShop, plugins, módulos y temas. Las actualizaciones suelen corregir bugs que pueden provocar errores de conexión.
  • Elige un hosting de calidad: Un buen hosting con soporte técnico eficiente y servidores estables es tu mejor seguro de vida.
  • Realiza copias de seguridad periódicas: Si algo sale mal, podrás restaurar tu web a un estado anterior sin pánico.
  • Monitoriza tu web: Usa herramientas gratuitas como UptimeRobot para que te avisen si tu web se cae.

Preguntas Frecuentes (FAQ)

¿Qué significa "error al establecer una conexión con la base de datos"?

Significa que tu web no puede comunicarse con el servidor donde se almacenan todos sus datos. Las causas más comunes son datos de acceso incorrectos, el servidor de base de datos caído o un ataque de fuerza bruta.

¿Cómo puedo arreglar el error de conexión a la base de datos en WordPress?

Primero, revisa el archivo wp-config.php y verifica que los nombres de la base de datos, usuario y contraseña sean correctos. Luego, asegúrate de que el host (DB_HOST) sea el correcto (normalmente "localhost", pero a veces es un servidor externo).

¿Qué hago si mi PrestaShop dice "Cannot connect to DB"?

El proceso es similar a WordPress. Revisa el archivo app/config/parameters.php y verifica los datos de conexión. Si los datos son correctos, intenta borrar la caché de PrestaShop, ya que a veces guarda información obsoleta.

¿Qué significa el error "Too many connections" en MySQL?

Este error ocurre cuando el número de conexiones simultáneas a tu base de datos supera el límite máximo permitido. Puede deberse a un plugin defectuoso, un pico de tráfico o consultas lentas. Reiniciar el servicio MySQL es una solución temporal, pero necesitas encontrar la causa raíz.

¿Cómo puedo aumentar el límite de conexiones MySQL?

Si tienes un VPS o servidor dedicado, puedes modificar la directiva max_connections en el archivo de configuración de MySQL (my.cnf). En hosting compartido, esta opción no está disponible y debes contactar con tu proveedor.

¿Qué es DB_HOST en WordPress y qué valor debo usar?

DB_HOST es la dirección del servidor donde se encuentra tu base de datos. En la mayoría de los hosting compartidos, es localhost. Sin embargo, algunos proveedores usan un host específico como mysql.midominio.com. Consulta la documentación de tu hosting para saber el valor correcto.

¿Por qué mi web muestra un error de base de datos después de cambiar la contraseña?

Porque has cambiado la contraseña en el servidor, pero no has actualizado el archivo de configuración de tu web (como wp-config.php o parameters.php). Es un error muy común y fácil de solucionar.

Conclusión: Tú puedes con esto

Hemos recorrido un largo camino, desde entender qué es la base de datos hasta solucionar los errores más comunes. La próxima vez que veas un error conexión base de datos, ya no será un motivo de pánico. Sabrás que es un problema con una solución lógica y que, con un poco de paciencia y esta guía, podrás resolverlo.

Recuerda el orden de actuación:

  1. Verifica los datos de acceso (usuario, contraseña, nombre de la base de datos).
  2. Comprueba el host y el puerto de conexión.
  3. Revisa si el servidor de base de datos está activo en tu panel de control.
  4. Si es "Too many connections", reinicia el servicio y busca al culpable.
  5. Si nada funciona, contacta con tu proveedor de hosting y muéstrale los pasos que ya has seguido. Esto les ayudará a ayudarte más rápido.

Con este conocimiento, no solo solucionarás el problema, sino que entenderás mejor cómo funciona tu web por dentro. ¡Adelante, tú puedes!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel