Problemas de conexión a base de datos en PrestaShop con cPanel

¿Tu tienda PrestaShop ha dejado de funcionar de repente y ves un mensaje de error que menciona la base de datos? No te preocupes, es uno de los problemas más comunes al gestionar una tienda online con cPanel. Vamos a solucionarlo paso a paso, como si estuviéramos al teléfono.

¿Por qué aparece el error de base de datos en PrestaShop con cPanel?

Cuando tu tienda PrestaShop muestra un mensaje como “Error de conexión a la base de datos” o “No se puede conectar con la base de datos”, significa que PrestaShop no puede comunicarse con el motor de base de datos (normalmente MySQL o MariaDB) que almacena toda la información de tu tienda: productos, clientes, pedidos, configuraciones, etc.

Este error base datos PrestaShop cPanel puede deberse a varias causas, desde un cambio de contraseña hasta un problema en el servidor. Lo bueno es que la mayoría tienen solución sin necesidad de ser un experto.

Causas más frecuentes del error de conexión

Antes de ponernos manos a la obra, identifiquemos qué puede estar pasando:

1. Contraseña de la base de datos incorrecta o cambiada

Es la causa más común. Si cambiaste la contraseña de la base de datos desde cPanel y no actualizaste el archivo de configuración de PrestaShop, la conexión falla.

2. Usuario o nombre de base de datos incorrecto

Puede que al mover la tienda a otro hosting o al restaurar una copia de seguridad, los datos de conexión no coincidan.

3. Servidor de base de datos caído o sobrecargado

A veces el problema no está en tu configuración, sino en el servidor. El hosting puede estar realizando mantenimiento o tener un pico de tráfico.

4. Archivos de configuración corruptos o mal editados

El archivo parameters.php o settings.inc.php de PrestaShop puede haberse dañado al hacer una actualización o al editar manualmente.

5. Problemas de permisos en la base de datos

El usuario de la base de datos puede no tener permisos suficientes para acceder desde el servidor web.

6. Cambio de servidor o migración

Al migrar tu tienda a otro hosting, si no actualizas los datos de conexión, obtendrás el error.

Diagnóstico rápido: ¿qué tipo de error ves?

PrestaShop muestra diferentes mensajes según la gravedad. Fíjate en esto:

• “Link to database cannot be established”: Error genérico de conexión.
• “Access denied for user ‘usuario’@’localhost’”: Usuario o contraseña incorrectos.
• “Unknown database ‘nombre_bd’”: El nombre de la base de datos no existe.
• “Table ‘ps_xxx’ doesn’t exist”: La estructura de la base de datos está dañada o incompleta.
• Página en blanco (white screen): A veces el error no se muestra, pero la tienda no carga.

Solución paso a paso para restaurar la conexión base datos PrestaShop

Vamos a resolverlo. Sigue estos pasos en orden. No te saltes ninguno.

Paso 1: Accede a cPanel y verifica los datos de la base de datos

1. Inicia sesión en tu cPanel (normalmente es tudominio.com/cpanel o tudominio.com:2083).
2. Busca la sección Bases de datos y haz clic en Bases de datos MySQL.
3. Verás una lista de bases de datos existentes. Localiza la que usa tu PrestaShop. Si no la recuerdas, busca en el siguiente paso.

[TIP] Si usas Syspanel (HestiaCP), el acceso es a través del puerto 2106 (ejemplo: tudominio.com:2106). Allí encontrarás una sección similar llamada "Bases de datos".

Paso 2: Encuentra el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión en un archivo llamado parameters.php (en versiones modernas) o settings.inc.php (en versiones antiguas). La ruta típica es:

/public_html/config/parameters.php

o

/public_html/config/settings.inc.php

1. En cPanel, ve a Administrador de archivos.
2. Navega hasta la carpeta public_html (o la carpeta donde esté instalada tu tienda).
3. Abre la carpeta config.
4. Busca el archivo parameters.php (o settings.inc.php). Haz clic derecho y selecciona Editar.

Paso 3: Revisa los datos de conexión en el archivo

Verás un contenido similar a este (en parameters.php):

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'tu_usuario_bd',
'database_user' => 'tu_usuario_bd',
'database_password' => 'tu_contraseña',

O en settings.inc.php:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_usuario_bd');
define('_DB_USER_', 'tu_usuario_bd');
define('_DB_PASSWD_', 'tu_contraseña');

Comprueba que estos datos coincidan exactamente con los que ves en cPanel en la sección Bases de datos MySQL.

[WARNING] No confundas el nombre de la base de datos con el nombre de usuario. En cPanel, a menudo se combinan: por ejemplo, usuarioCpanel_nombreBD. Ambos deben ser iguales.

Paso 4: Verifica la contraseña desde cPanel

1. En cPanel, en Bases de datos MySQL, busca el usuario de tu base de datos.
2. Haz clic en Cambiar contraseña (o Cambiar usuario).
3. Establece una contraseña nueva y segura. Anótala.
4. Vuelve al archivo de configuración y actualiza database_password o _DB_PASSWD_ con esa nueva contraseña.
5. Guarda los cambios (icono de disco o Ctrl+S).

Paso 5: Comprueba los permisos del usuario

1. En Bases de datos MySQL, busca la sección Añadir usuario a la base de datos (o Usuarios de bases de datos).
2. Asegúrate de que el usuario que estás usando esté vinculado a la base de datos correcta.
3. Verifica que tenga TODOS LOS PRIVILEGIOS marcados (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, selecciona todos y guarda.

Paso 6: Prueba la conexión manualmente

Para asegurarte de que los datos funcionan, puedes hacer una prueba rápida:

1. En cPanel, busca phpMyAdmin (dentro de Bases de datos).
2. Intenta iniciar sesión con el usuario y contraseña que tienes en el archivo de configuración.
3. Si phpMyAdmin te deja entrar, la conexión es correcta. Si no, revisa los datos otra vez.

Paso 7: Verifica que el servidor MySQL esté activo

Si todo lo anterior está bien, el problema puede ser del servidor:

1. En cPanel, busca Estado del servidor o Información del servidor.
2. Busca si MySQL/MariaDB aparece como "En ejecución".
3. Si está detenido, contacta a tu proveedor de hosting. No podrás reiniciarlo desde cPanel.

[INFO] Algunos hostings compartidos pueden tener límites de conexiones simultáneas. Si tu tienda recibe mucho tráfico, puede saturarse. En ese caso, considera aumentar los recursos o cambiar a un plan mejor.

Paso 8: Soluciona errores de tabla dañada

Si el error persiste y ves mensajes como “Table doesn’t exist” o “Table is marked as crashed”, puedes reparar las tablas:

1. En phpMyAdmin, selecciona la base de datos de tu tienda.
2. Marca todas las tablas (clic en “Seleccionar todo”).
3. En el menú desplegable “Con selección:”, elige Reparar tabla.
4. Espera a que termine. Si hay muchas tablas, puede tardar unos segundos.

¿Qué hacer si nada funciona? Restaurar desde una copia de seguridad

Si después de todos estos pasos sigues sin conexión base datos PrestaShop, es posible que el archivo de configuración esté corrupto o que hayas perdido datos. Entonces:

1. Restaura una copia de seguridad reciente de tu base de datos desde cPanel (sección Copias de seguridad).
2. Restaura también los archivos de tu tienda (especialmente la carpeta config).
3. Vuelve a verificar los datos de conexión.

[WARNING] Siempre haz una copia de seguridad antes de hacer cambios importantes. En cPanel puedes generar backups completos fácilmente.

Preguntas frecuentes (FAQ) sobre error base datos PrestaShop cPanel

¿Puedo cambiar el nombre de la base de datos sin perder datos?

Sí, pero con cuidado. Debes exportar la base de datos, crear una nueva con el nombre deseado, importar los datos y luego actualizar el archivo de configuración. Es más seguro hacerlo desde phpMyAdmin.

¿El error puede deberse a un plugin o módulo?

Sí, algunos módulos mal codificados pueden corromper la conexión. Si el error apareció tras instalar un módulo, desactívalo desde la base de datos (cambiando su estado a 0 en la tabla ps_module).

¿Cómo sé si mi hosting usa localhost como servidor de base de datos?

En el 99% de los casos sí. Si no, tu proveedor te habrá dado una dirección IP o un nombre de servidor (ejemplo: mysql.tudominio.com). Revísalo en la documentación de tu hosting.

¿Puedo evitar este error en el futuro?

Sí:

• Usa contraseñas seguras y no las cambies a menos que sea necesario.
• Antes de hacer cambios en cPanel, anota los datos actuales.
• Realiza copias de seguridad semanales.
• Mantén PrestaShop y sus módulos actualizados.

Conclusión: tu tienda volverá a funcionar

El error base datos PrestaShop cPanel suena alarmante, pero casi siempre tiene solución. Lo más importante es mantener la calma y seguir estos pasos de forma ordenada. Recuerda que la mayoría de las veces se trata de un simple error de contraseña o de nombre de usuario.

Si después de todo el problema persiste, contacta a tu proveedor de hosting. Ellos pueden verificar el estado del servidor MySQL y ayudarte con permisos más avanzados.

Y recuerda: si usas Syspanel (HestiaCP), el puerto de acceso es el 2106 y las herramientas son muy similares a las de cPanel, solo que con nombres distintos.

¿Has logrado resolverlo? ¡Cuéntanos en los comentarios! Y si te quedó alguna duda, aquí estamos para ayudarte.