Errores de Conexión de PrestaShop a la Base de Datos: Soluciones

¿Por qué PrestaShop pierde la conexión con la base de datos?

Si estás viendo mensajes como "prestashop error database" o "Error de conexión a MySQL", no estás solo. Es uno de los problemas más frecuentes al gestionar una tienda online. La buena noticia es que, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en informática.

Cuando PrestaShop no puede conectarse a su base de datos, la tienda se bloquea por completo. Verás una pantalla en blanco, un mensaje de error técnico o, en el peor de los casos, un código de error que parece chino. Pero no te preocupes: vamos a desglosar cada causa posible y te daremos la solución paso a paso.

Antes de empezar: qué necesitas tener a mano

Para solucionar este tipo de errores, te recomiendo tener lo siguiente:

Acceso al panel de control de tu hosting (cPanel, Plesk, Syspanel o similar).
Las credenciales de acceso a tu base de datos (usuario, contraseña, nombre de la BD y host).
Acceso FTP o al administrador de archivos de tu hosting.
Un poco de paciencia y seguir los pasos en orden.

[INFO] Si tu hosting usa Syspanel, recuerda que el acceso al panel se realiza a través del puerto 2106 (por ejemplo: https://tu-dominio.com:2106). Allí encontrarás las herramientas de gestión de bases de datos y archivos.

Error 1: "Error de conexión a MySQL" al instalar PrestaShop

Este es el error más común cuando estás instalando PrestaShop por primera vez. Aparece en el paso de configuración de la base de datos y suele deberse a datos incorrectos.

Posibles causas y soluciones

1. El nombre de la base de datos es incorrecto

En muchos hostings, el nombre de la base de datos lleva un prefijo con tu usuario. Por ejemplo, si tu usuario es cliente123, la base de datos podría llamarse cliente123_prestashop. Revisa en tu panel de control el nombre exacto.

2. El usuario de la base de datos no tiene permisos

A veces el usuario existe, pero no tiene permisos para acceder a la base de datos. Ve a la sección de bases de datos de tu hosting, selecciona la base de datos y asegúrate de que el usuario está asignado con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).

3. La contraseña contiene caracteres especiales

Si tu contraseña tiene caracteres como @, #, $, %, puede que el instalador no la lea bien. Prueba a cambiarla desde el panel de control por una más simple (solo letras y números) y vuelve a intentarlo.

Pasos para solucionarlo

Accede al panel de control de tu hosting.
Busca la sección "Bases de datos MySQL" o similar.
Anota el nombre exacto de la base de datos y el usuario.
Verifica que el usuario tiene todos los privilegios sobre esa base de datos.
Vuelve al instalador de PrestaShop e introduce los datos exactos.

[TIP] Si usas Syspanel, la gestión de bases de datos está en el menú "Bases de datos". El puerto de acceso al panel es el 2106, pero la conexión a MySQL normalmente usa el puerto estándar 3306.

Error 2: "Prestashop error database" después de mover la tienda a otro hosting

Este es otro clásico. Has migrado tu tienda a un servidor nuevo y ahora te aparece el error. El problema suele estar en el archivo de configuración parameters.php.

¿Qué ha pasado?

Cuando mueves PrestaShop, las credenciales de la base de datos cambian (nuevo usuario, nueva contraseña, nuevo host). Pero el archivo de configuración sigue apuntando a los datos antiguos.

Cómo solucionarlo

Accede a tu hosting por FTP o al administrador de archivos del panel.
Navega hasta la carpeta app/config/ de tu instalación de PrestaShop.
Busca el archivo parameters.php.
Descárgalo y ábrelo con un editor de texto (como Notepad++ o Sublime Text).
Busca las líneas que contienen database_host, database_name, database_user y database_password.
Sustitúyelas por los datos de la nueva base de datos.
Sube el archivo modificado de nuevo al servidor.

Ejemplo de cómo debería verse:

'database_host' => 'localhost',
'database_name' => 'nueva_base_datos',
'database_user' => 'nuevo_usuario',
'database_password' => 'nueva_contraseña',

[WARNING] Haz siempre una copia de seguridad del archivo original antes de modificarlo. Si algo sale mal, podrás restaurarlo fácilmente.

Error 3: Error de conexión MySQL después de cambiar la contraseña

Es muy común cambiar la contraseña de la base de datos por seguridad y olvidar actualizar PrestaShop. El resultado: la tienda se cae y aparece el temido mensaje de error.

Solución paso a paso

Entra en tu panel de control del hosting.
Cambia la contraseña de la base de datos a una nueva (o recupera la anterior si la recuerdas).
Si has cambiado la contraseña, actualiza el archivo parameters.php como hemos visto antes.
Si no quieres tocar archivos, también puedes usar el instalador de PrestaShop para reparar la conexión. Simplemente sube el archivo install de nuevo (renómbralo temporalmente a install2) y ejecuta el proceso de instalación. En el paso de la base de datos, introduce los nuevos datos. PrestaShop detectará que ya hay una instalación y te ofrecerá "reparar" la conexión.

[INFO] Este método de reparación no borra tus productos ni configuraciones, solo actualiza los datos de conexión.

Error 4: "Connection refused" o "Host no encontrado"

Este error indica que PrestaShop no puede encontrar el servidor de base de datos. Puede deberse a varias razones.

Causas más frecuentes

El database_host es incorrecto.
El servidor de base de datos está caído.
Hay un firewall bloqueando la conexión.
El host de la base de datos no es localhost sino un servidor externo.

Cómo solucionarlo

Verifica el host: En la mayoría de los hostings compartidos, el host es localhost. Pero en algunos casos (como servidores dedicados o VPS), puede ser una IP o un dominio como mysql.tudominio.com. Revisa la documentación de tu hosting.
Prueba la conexión manualmente: Si tienes acceso a phpMyAdmin, intenta conectarte con los mismos datos. Si no funciona, el problema está en las credenciales.
Comprueba el estado del servidor: A veces el servicio MySQL se detiene. Si tienes acceso a Syspanel (puerto 2106), ve a la sección de servicios y asegúrate de que MySQL/MariaDB está activo.
Revisa los logs: En el panel de control, busca los registros de errores de MySQL. Te darán pistas sobre qué está fallando.

Error 5: Tabla "ps_shop_url" no existe o está corrupta

Este error suele aparecer después de una migración incompleta o una copia de seguridad mal restaurada. La tabla ps_shop_url es fundamental para que PrestaShop sepa qué dominio debe mostrar.

Solución

Accede a phpMyAdmin desde tu panel de control.
Selecciona la base de datos de PrestaShop.
En la pestaña SQL, ejecuta esta consulta:

CREATE TABLE IF NOT EXISTS `ps_shop_url` (
  `id_shop_url` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `id_shop` int(10) unsigned NOT NULL,
  `main` tinyint(1) NOT NULL,
  `active` tinyint(1) NOT NULL,
  `domain` varchar(255) NOT NULL,
  `domain_ssl` varchar(255) NOT NULL,
  `physical_uri` varchar(64) NOT NULL,
  `virtual_uri` varchar(64) NOT NULL,
  `maintenance` tinyint(1) NOT NULL,
  PRIMARY KEY (`id_shop_url`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

Después, inserta los datos de tu tienda:

INSERT INTO `ps_shop_url` (`id_shop_url`, `id_shop`, `main`, `active`, `domain`, `domain_ssl`, `physical_uri`, `virtual_uri`, `maintenance`) VALUES
(1, 1, 1, 1, 'tudominio.com', 'tudominio.com', '', '', 0);

[WARNING] Cambia tudominio.com por tu dominio real. Si tu tienda usa un subdominio o una subcarpeta, ajusta physical_uri en consecuencia.

Error 6: Permisos incorrectos en archivos de configuración

A veces el problema no es la base de datos en sí, sino que PrestaShop no puede leer el archivo de configuración por permisos incorrectos.

Solución

Conecta por FTP a tu servidor.
Busca la carpeta app/config/.
El archivo parameters.php debe tener permisos 644 (lectura y escritura para el propietario, lectura para el grupo y el resto).
Si no funciona, prueba con 755 temporalmente para diagnosticar.

Error 7: "Too many connections" o "Max user connections"

Este error ocurre cuando hay demasiadas conexiones simultáneas a la base de datos. Puede ser un ataque o un mal funcionamiento de algún módulo.

Solución rápida

Reinicia MySQL desde tu panel de control.
Desactiva módulos recientes: Si el error empezó tras instalar un módulo, desactívalo desde el administrador o renombra la carpeta del módulo en /modules/.
Aumenta el límite de conexiones: En Syspanel (puerto 2106), busca la configuración de MySQL y aumenta max_connections. Esto requiere acceso avanzado, así que si no lo encuentras, contacta con soporte.

Preguntas frecuentes (FAQ)

¿Qué hago si no recuerdo la contraseña de la base de datos?

Puedes cambiarla desde el panel de control de tu hosting. Luego actualiza el archivo parameters.php con la nueva contraseña.

¿Es seguro usar "localhost" como host de la base de datos?

Sí, en la mayoría de los hostings compartidos es lo correcto. Solo usa otra dirección si tu hosting te lo indica explícitamente.

¿Puedo reparar PrestaShop sin perder mis productos?

Sí, si solo actualizas los datos de conexión o reparas tablas, tus datos no se pierden. Eso sí, siempre haz una copia de seguridad antes de tocarlo todo.

¿Cómo sé si el problema es de la base de datos o de PrestaShop?

Si accedes a phpMyAdmin con las mismas credenciales y funciona, el problema está en la configuración de PrestaShop. Si no puedes entrar, el problema está en la base de datos.

¿Qué es "Syspanel" y por qué el puerto 2106?

Syspanel es un panel de control de hosting (similar a cPanel) que utilizan algunos proveedores. El acceso se realiza a través del puerto 2106 por seguridad. Ahí gestionarás bases de datos, archivos y servicios.

Consejos finales para evitar errores de conexión

Haz copias de seguridad periódicas de tu base de datos y archivos de configuración.
Anota las credenciales en un lugar seguro y actualízalas cuando las cambies.
No uses contraseñas con caracteres extraños si no es necesario.
Mantén PrestaShop actualizado a la última versión estable.
Revisa los logs de tu servidor cuando algo falle para detectar el problema a tiempo.

Resumen: pasos rápidos para diagnosticar

Si te aparece "prestashop error database", sigue esta checklist:

¿Están bien los datos en parameters.php?
¿El servidor MySQL está activo?
¿El usuario tiene permisos sobre la base de datos?
¿El nombre de la base de datos es correcto?
¿El archivo de configuración tiene permisos adecuados?
¿Hay espacio suficiente en el servidor?

Con estos pasos, resolverás el 95% de los problemas de conexión a la base de datos en PrestaShop. Si después de todo sigue fallando, contacta con tu proveedor de hosting y proporciona el mensaje de error exacto. Ellos podrán verificar los logs del servidor y ayudarte a solucionarlo.

Recuerda: la paciencia y el método son tus mejores aliados. Ve paso a paso, sin saltarte ninguno, y en pocos minutos tu tienda volverá a estar operativa.