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

Errores comunes de conexión a base de datos en WordPress y PrestaShop (cPanel, Plesk, DirectAdmin)

Actualizado el 16 de octubre de 2025

¿Qué significa el error de conexión a la base de datos?

Si estás leyendo esto, es muy probable que hayas visto una pantalla blanca con un mensaje parecido a "Error establishing a database connection" (en WordPress) o "Error de conexión con la base de datos" (en PrestaShop). No te preocupes, es uno de los fallos más comunes y, en la mayoría de los casos, tiene una solución sencilla.

Este error significa que tu sitio web (el código PHP) no puede comunicarse con el servidor donde se almacenan tus datos (MySQL o MariaDB). Sin esa comunicación, tu web no puede cargar artículos, productos, usuarios ni nada.

A lo largo de esta guía, vamos a desglosar los errores de conexión a base de datos más habituales en WordPress y PrestaShop, especialmente cuando tu hosting usa paneles de control como cPanel, Plesk o DirectAdmin. También veremos cómo solucionarlos paso a paso, incluso si no eres un experto técnico.

¿Por qué ocurre el error de conexión a base de datos?

Antes de lanzarnos a arreglar nada, es importante entender qué está pasando. Cuando tu web intenta conectarse a la base de datos, necesita cuatro datos "secretos":

  1. El servidor de la base de datos (normalmente localhost o una dirección como mysql.tudominio.com).
  2. El nombre de la base de datos (ej: usuario_wpdb).
  3. El usuario de la base de datos (ej: usuario_admin).
  4. La contraseña de ese usuario.

Si cualquiera de estos datos es incorrecto, o si el servidor MySQL está caído o bloqueado, obtendrás el temido error mysql conexion.

[INFO] En la mayoría de los casos, el error no se debe a que hayas perdido datos. Tus tablas y registros siguen ahí. Simplemente, tu web ha perdido la "llave" para entrar a verlos.

Error de conexión en WordPress: El clásico "Error establishing a database connection"

Este es, sin duda, el error más famoso. Puede aparecer en la portada de tu web, en el panel de administración (wp-admin) o en ambos. Las causas más comunes son las siguientes.

1. Credenciales incorrectas en wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Si se han cambiado las credenciales de la base de datos (por ejemplo, al migrar de hosting) y no se han actualizado aquí, el error es inmediato.

¿Cómo solucionarlo?

  1. Accede a tu panel de control (cPanel, Plesk o DirectAdmin) y abre el Administrador de Archivos.
  2. Navega hasta la carpeta raíz de tu WordPress (normalmente public_html).
  3. Busca el archivo wp-config.php. Si no lo ves, activa la opción "Mostrar archivos ocultos".
  4. Haz clic derecho y selecciona Editar.
  5. Busca estas líneas: 
    define( 'DB_NAME', 'aqui_el_nombre_db' );
define( 'DB_USER', 'aqui_usuario_db' );
define( 'DB_PASSWORD', 'aqui_contraseña_db' );
define( 'DB_HOST', 'localhost' );
  6. Verifica que estos datos coinciden EXACTAMENTE con los que ves en tu panel de control (en la sección "Bases de datos MySQL").
  7. Si no estás seguro, crea una nueva contraseña para el usuario de la base de datos desde tu panel y pégala aquí.

[WARNING] No cambies el valor de DB_HOST a menos que tu proveedor de hosting te lo indique. Normalmente es localhost, pero algunos hosts usan direcciones como mysql.tudominio.com. Cambiarlo sin saber puede romper la conexión.

2. El servidor MySQL está sobrecargado o caído

A veces, el error no es tuyo, sino del servidor. Si el servidor de bases de datos está reiniciándose o tiene un pico de carga, puede rechazar conexiones temporalmente.

¿Cómo comprobarlo?

  • Si tienes acceso a cPanel, busca el icono "Estado del Servidor" o "MySQL Status". Verás si el servicio está "Running" o "Stopped".
  • En Plesk, ve a "Herramientas y Configuración" -> "Servicios del Servidor".
  • En DirectAdmin, mira en "Información del Sistema" o en la pestaña "Servicios".

¿Cómo solucionarlo?

  • Si está detenido, intenta iniciarlo desde el mismo panel. Si no tienes permisos, contacta con tu proveedor de hosting inmediatamente.
  • Si está activo pero tu web sigue dando el error, espera 5-10 minutos. A veces es un pico puntual de tráfico.

3. El archivo wp-config.php se ha corrompido o está mal codificado

Si al editar el archivo con un editor de texto (como el Bloc de notas) lo guardaste con una codificación incorrecta (ej: UTF-8 con BOM), WordPress puede fallar al leerlo.

¿Cómo solucionarlo?

  1. Descarga el archivo wp-config.php a tu ordenador.
  2. Ábrelo con un editor avanzado como Notepad++ o Sublime Text.
  3. Ve a Codificación y asegúrate de que está en "UTF-8 sin BOM".
  4. Guárdalo y súbelo de nuevo, reemplazando el anterior.

Error de conexión en PrestaShop: "No se puede conectar con la base de datos"

PrestaShop es un poco más quisquilloso. Aquí el error suele mostrarse durante la instalación, al migrar la tienda o tras cambiar la contraseña de la base de datos. El mensaje suele ir acompañado de detalles técnicos.

1. Parámetros desactualizados en parameters.php

A diferencia de WordPress, PrestaShop guarda la configuración en un archivo llamado parameters.php, ubicado en la carpeta app/config/.

¿Cómo solucionarlo?

  1. Accede al Administrador de Archivos de tu panel (cPanel, Plesk o DirectAdmin).
  2. Ve a la ruta public_html/app/config/.
  3. Busca el archivo parameters.php.
  4. Ábrelo y busca la sección 'database_host', 'database_name', 'database_user' y 'database_password'.
  5. Actualiza estos valores con los correctos de tu base de datos.
  6. Importante: Después de editar, guarda el archivo y borra la carpeta var/cache (o la carpeta cache en versiones antiguas) para que PrestaShop no use los datos antiguos.

2. Problemas con el prefijo de las tablas

A veces, al importar una copia de seguridad, el prefijo de las tablas (ej: ps_) no coincide con el que PrestaShop espera encontrar. Esto también puede generar un error de conexión o de "tabla no encontrada".

¿Cómo solucionarlo?

  • Revisa en parameters.php el valor de 'database_prefix'.
  • Conéctate a tu base de datos usando phpMyAdmin (desde tu panel de control).
  • Mira el listado de tablas. Si tus tablas se llaman tienda_orders y el archivo dice ps_, tendrás que cambiar el prefijo en el archivo o renombrar las tablas.

[TIP] Si no te sientes cómodo editando archivos de configuración, muchos hosts ofrecen un "Asistente de Reparación de PrestaShop". Consulta la documentación de tu hosting o busca en Google "Reparar tienda PrestaShop".

El error "mysql host no encontrado" (Unknown MySQL server host)

Este es un error específico y muy claro: tu aplicación no encuentra el servidor de base de datos. Es menos común que el error genérico, pero suele aparecer al configurar una web en un servidor externo o al usar una IP incorrecta.

¿Por qué ocurre?

  • Has puesto una dirección IP mal escrita en el campo DB_HOST o database_host.
  • El servidor de base de datos está en un puerto diferente al estándar (3306) y no lo has especificado.
  • Estás usando un nombre de host que no existe (ej: mysql.tudominio.com cuando el real es localhost).

¿Cómo solucionarlo?

  1. Vuelve a tu panel de control y busca la sección de "Bases de Datos MySQL".
  2. Busca el nombre del servidor. En cPanel, suele aparecer como localhost o 127.0.0.1. En algunos casos, verás algo como mysql.tudominio.com.
  3. Copia y pega EXACTAMENTE ese valor en tu archivo de configuración.
  4. Si tu base de datos usa un puerto especial, deberás añadirlo al final. Por ejemplo: localhost:3307 o mysql.tudominio.com:3306.

[WARNING] Si tu web está en un hosting compartido, es casi imposible que el servidor de base de datos sea externo. Si has migrado la web, asegúrate de que los datos de la base de datos también se hayan migrado al nuevo servidor.

Solución paso a paso: Diagnóstico general para cPanel, Plesk y DirectAdmin

Independientemente del panel que uses, este flujo de trabajo te ayudará a resolver el 90% de los casos.

Paso 1: Verifica que la base de datos existe y tiene tablas

  1. Entra en phpMyAdmin desde tu panel de control.
  2. Haz clic en el nombre de tu base de datos (a la izquierda).
  3. Mira si hay tablas en el lado derecho. Si no hay tablas, tu web está rota o la base de datos está vacía.
  4. Si está vacía, deberás importar una copia de seguridad (archivo .sql).

Paso 2: Comprueba los permisos del usuario

A veces, el usuario de la base de datos existe, pero no tiene "permisos" para acceder a ella.

  1. En cPanel, ve a "Bases de Datos MySQL".
  2. Busca la sección "Añadir Usuario a la Base de Datos".
  3. Asegúrate de que el usuario correcto está vinculado a la base de datos correcta.
  4. Marca la casilla de "TODOS LOS PRIVILEGIOS" y haz clic en "Hacer cambios".
  5. En Plesk o DirectAdmin, el proceso es similar (busca "Usuarios de Bases de Datos" y edita los permisos).

Paso 3: Revisa los archivos de configuración

Ya lo hemos mencionado, pero es el paso clave. Repasa:

  • WordPress: wp-config.php
  • PrestaShop: app/config/parameters.php

Asegúrate de que no haya espacios en blanco o caracteres extraños alrededor de los valores.

Paso 4: Prueba la conexión manualmente

Si tienes acceso a la terminal (SSH) de tu hosting, puedes probar la conexión directamente. No te asustes, es un comando muy simple:

mysql -u TU_USUARIO -p TU_BASE_DE_DATOS -h TU_HOST

Te pedirá la contraseña. Si te conecta sin errores, el problema está en los archivos de configuración. Si te da un error de acceso, el problema está en las credenciales o los permisos.

Preguntas Frecuentes (FAQ)

¿He perdido mis datos si veo este error?

No. El error de conexión no borra datos. Tus tablas y registros siguen almacenados en el servidor MySQL. Solo necesitas restablecer la comunicación entre tu web y la base de datos.

¿Por qué me pasa esto después de migrar mi hosting?

Es la causa número uno. Al migrar, las credenciales de la base de datos suelen cambiar. Debes actualizar los archivos de configuración (wp-config.php o parameters.php) con los datos del nuevo hosting.

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

No la "recuperas" como en un email. Simplemente la cambias desde tu panel de control:

  1. Ve a la sección de Bases de Datos MySQL.
  2. Busca "Cambiar contraseña" o "Editar usuario".
  3. Crea una nueva contraseña segura.
  4. Actualiza el archivo de configuración de tu web con la nueva contraseña.

¿Puede un plugin o un tema causar este error?

Sí, pero es raro. Un plugin mal codificado puede saturar la base de datos, pero no suele cambiar las credenciales. Sin embargo, si el plugin crea muchas tablas temporales, puede agotar los recursos del servidor y provocar errores de conexión temporal. Si el error empezó tras instalar un plugin, desactívalo por FTP renombrando la carpeta del plugin.

Mi hosting usa Syspanel (HestiaCP). ¿Es diferente?

No te preocupes, el proceso es el mismo. Syspanel (la versión moderna de HestiaCP) es otro panel de control más. Accede a él usando el puerto 2106 (ej: https://tudominio.com:2106). Dentro, busca la sección "Bases de Datos" o "Base de datos MySQL". La lógica es idéntica a cPanel: verás el nombre de la base, el usuario y podrás cambiar la contraseña. Luego, edita los archivos de configuración como hemos explicado.

¿Debo contactar con mi proveedor de hosting?

Si has seguido todos los pasos y el error persiste, sí. Puede ser un problema del servidor (firewall, límites de conexión, etc.) que solo ellos pueden solucionar. En tu mensaje, incluye el error exacto que ves (ej: "error mysql conexion" o "mysql host no encontrado") y qué pasos has probado ya.

Conclusión

El error conexion base de datos wordpress o el error base de datos prestashop pueden parecer un muro infranqueable, pero con paciencia y siguiendo esta guía, podrás solucionarlo en la mayoría de los casos. Recuerda: revisa las credenciales, verifica los permisos y comprueba que el servidor MySQL esté activo.

La próxima vez que veas una pantalla blanca, respira hondo. Ahora ya sabes por dónde empezar a buscar la solucion error base de datos.

¿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