Error de base de datos en PrestaShop: Soluciones en cPanel y Plesk

¿Tu tienda PrestaShop se ha quedado en blanco o muestra un mensaje de error relacionado con la base de datos? No te preocupes, es uno de los problemas más comunes, pero también de los que más asustan al principio. Un error base datos PrestaShop puede aparecer de repente, impidiendo que accedas a tu tienda o al panel de administración.

Pero respira hondo. En la mayoría de los casos, la solución es más sencilla de lo que parece. Esta guía está diseñada para que, paso a paso, puedas diagnosticar y resolver el problema, incluso si no eres un experto técnico. Vamos a desglosar las causas más frecuentes y cómo solucionarlas.

¿Qué significa exactamente un "error de conexión a base de datos"?

Imagina que tu tienda PrestaShop es una biblioteca. Los archivos de tu tienda (las estanterías) están en el servidor, pero el catálogo de libros (productos, clientes, pedidos) está en una sala especial llamada base de datos MySQL. Para que la biblioteca funcione, el bibliotecario (PrestaShop) necesita entrar a esa sala.

El error de conexión ocurre cuando PrestaShop no encuentra la puerta de entrada a esa sala, ha perdido la llave, o la sala está cerrada con llave por dentro. El mensaje típico puede ser: "Error de conexión a la base de datos" o "Link to database cannot be established".

Síntomas comunes de un error de base de datos

Antes de ponernos manos a la obra, identifica si estos síntomas te suenan:

Pantalla en blanco (White Screen of Death): La tienda no carga nada, solo un fondo blanco.
Mensaje de error directo: Un texto que dice explícitamente que hay un problema con la conexión MySQL PrestaShop.
Errores al intentar acceder al back-office: No puedes ni siquiera iniciar sesión como administrador.
Tienda lenta o con partes que no funcionan: A veces el error no es total, pero ciertas funcionalidades (como el carrito o el catálogo) fallan.

Causas principales del error y cómo solucionarlas

Vamos a ir de lo más simple a lo más complejo. Sigue estos pasos en orden, ya que la mayoría de las veces el problema está en el primer o segundo punto.

1. Verifica las credenciales en el archivo de configuración (settings.inc.php)

Este es el punto de partida obligatorio. PrestaShop guarda los datos de acceso a tu base de datos en un archivo llamado settings.inc.php. Si este archivo se corrompe, se modifica accidentalmente o tiene datos incorrectos, el error es inmediato.

¿Cómo localizarlo y revisarlo?

Accede a tu servidor web. Puedes hacerlo mediante un cliente FTP (como FileZilla) o a través del administrador de archivos de tu panel de control (cPanel, Syspanel, etc.).
Navega hasta la carpeta raíz donde está instalado PrestaShop. Normalmente se llama public_html o www.
Dentro, busca la carpeta config y luego el archivo settings.inc.php.
Ábrelo con un editor de texto plano (como Bloc de Notas o Sublime Text). No uses Word ni procesadores de texto.

Busca las siguientes líneas. Deberían verse algo así:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base_de_datos');
define('_DB_USER_', 'usuario_de_la_base');
define('_DB_PASSWD_', 'contraseña_secreta');
define('_DB_PREFIX_', 'ps_');

¿Qué debes comprobar?

DB_SERVER: Casi siempre es localhost, pero si tu hosting usa un servidor de base de datos externo, aquí debe ir la dirección IP o el nombre del servidor (ej: mysql.tudominio.com). Pregunta a tu proveedor de hosting si no estás seguro.
DB_NAME, DB_USER, DB_PASSWD: Estos datos son los que creaste al instalar PrestaShop. Si no los recuerdas, puedes consultarlos en el panel de control de tu hosting.
- En Syspanel (HestiaCP): Accede a tu panel en https://tudominio.com:2106. Ve a la sección de Base de Datos. Allí verás el nombre de la base de datos, el usuario y podrás cambiar la contraseña.
- En cPanel: Busca la sección Bases de Datos MySQL.
DB_PREFIX: Es el prefijo de las tablas. Por defecto es ps_, pero puede ser diferente. Si cambiaste de hosting o hiciste una migración, este prefijo debe coincidir con el de las tablas reales en tu base de datos.

[WARNING]: Si cambias la contraseña en este archivo, asegúrate de que coincida exactamente con la que tiene el usuario en la base de datos. Un simple error tipográfico (mayúsculas, minúsculas o caracteres especiales) romperá la conexión.

2. Comprueba que el servidor MySQL esté funcionando

A veces el problema no es tuyo, sino del servidor. El servicio de MySQL puede haberse caído o reiniciado.

Si tienes acceso a Syspanel (HestiaCP): Inicia sesión en https://tudominio.com:2106. Busca la sección de Servicios o Service Status. Verifica que el servicio MySQL o MariaDB esté marcado en verde (activo). Si está en rojo, puedes intentar reiniciarlo desde el mismo panel.
Si usas cPanel: Busca la sección Estado del Servidor o MySQL® Databases y verifica que todo esté operativo.
Si tienes un VPS o servidor dedicado: Puedes conectarte por SSH y usar comandos como systemctl status mysql o service mysql status. Si no sabes cómo hacerlo, contacta con tu proveedor de hosting.

[INFO]: Es muy común que después de una actualización del sistema o un pico de tráfico, el servicio MySQL se reinicie y por un breve instante dé un error. Si es un error intermitente, espera 5 minutos y recarga la página.

3. Repara la base de datos desde phpMyAdmin

Con el tiempo, las tablas de tu base de datos pueden corromperse ligeramente, sobre todo si hubo un corte de luz o un cierre inesperado del servidor. Esto causa el famoso PrestaShop database error.

Afortunadamente, MySQL tiene una herramienta para reparar tablas: phpMyAdmin.

Pasos para reparar la base de datos:

Accede a phpMyAdmin. Normalmente está en una URL como tudominio.com/phpmyadmin o desde el panel de control de tu hosting.
- En Syspanel: Ve a la sección Base de Datos y haz clic en phpMyAdmin junto a la base de datos de tu tienda.
Inicia sesión con el usuario y contraseña de tu base de datos (los mismos del settings.inc.php).
A la izquierda, verás una lista de bases de datos. Haz clic en la que corresponde a tu PrestaShop.
Verás una lista de todas las tablas (ej: ps_address, ps_cart, etc.). Marca la casilla de Seleccionar todo que está al final de la lista.
En el menú desplegable "Con seleccionados:", elige la opción Reparar tabla.
phpMyAdmin ejecutará el comando REPAIR TABLE en todas las tablas. Al final, te mostrará un resultado. Si todo está bien, dirá "OK" o "Table is already up to date".

[TIP]: Si el error persiste después de reparar, puedes intentar Optimizar tabla. Esto no repara, pero reorganiza los datos y a veces soluciona problemas de rendimiento que se confunden con errores de conexión.

4. Revisa los permisos del usuario de la base de datos

El usuario que usa PrestaShop para conectarse debe tener ciertos permisos sobre la base de datos. Si por error se le quitaron, la conexión fallará.

¿Cómo verificarlo en phpMyAdmin?

Una vez en phpMyAdmin, haz clic en la pestaña Privilegios o Cuentas de usuario (suele estar arriba).
Busca el usuario que coincide con el de tu archivo settings.inc.php.
Haz clic en Editar privilegios.
Asegúrate de que tenga marcados los privilegios DATOS (SELECT, INSERT, UPDATE, DELETE) y ESTRUCTURA (CREATE, ALTER, INDEX, DROP). Para una tienda, lo más seguro es marcar Seleccionar todo en la sección de "Privilegios de base de datos".

[WARNING]: No le quites permisos si no estás seguro. Si ves que no tiene ningún privilegio, selecciona "Marcar todos" y guarda los cambios.

5. Verifica la conexión a Internet y el Firewall

A veces la solución es más mundana de lo que crees.

Tu conexión a Internet: Un corte momentáneo puede impedir que tu navegador cargue la tienda. Prueba a acceder desde otro dispositivo o red (por ejemplo, desde el móvil con datos).
Firewall del servidor: Si tu proveedor de hosting tiene un firewall muy restrictivo, puede estar bloqueando las conexiones al puerto de MySQL (puerto 3306). Esto es raro, pero sucede en entornos muy seguros. Contacta con el soporte de tu hosting y pregúntales si hay alguna restricción de IP o puerto para la conexión MySQL.

6. Revisa el espacio en disco del servidor

Parece increíble, pero si el disco duro de tu servidor está lleno, MySQL no puede escribir datos temporales ni registros, y se cuelga. Esto genera un error de conexión.

En Syspanel (HestiaCP): En el panel principal, suele haber un indicador de uso de disco. También puedes ir a Herramientas del Sistema > Estadísticas del Servidor.
En cPanel: Busca la sección Estadísticas o Uso del Disco.

Si el disco está al 100%, deberás liberar espacio: eliminar copias de seguridad antiguas, logs de error, o archivos temporales de PrestaShop (como los de la carpeta /cache).

7. ¿Problemas con el archivo .htaccess?

Aunque menos común, un archivo .htaccess corrupto puede interferir con la forma en que PrestaShop se conecta a la base de datos, especialmente si hay reglas de redirección mal escritas.

Solución rápida: Renombra tu archivo .htaccess a .htaccess_old (desde FTP o el administrador de archivos). Luego, intenta acceder a tu tienda. Si funciona, el problema estaba ahí. Después, desde el back-office de PrestaShop (si puedes entrar), ve a Parámetros de la tienda > Tráfico y SEO y vuelve a generar el archivo .htaccess.

8. La solución de emergencia: restaurar una copia de seguridad

Si has llegado hasta aquí y nada funciona, es posible que la base de datos esté gravemente dañada. Este es el momento de usar tu copia de seguridad.

[INFO]: ¡Siempre debes tener copias de seguridad periódicas de tu base de datos y archivos! Es tu salvavidas.

¿Cómo restaurar una copia de la base de datos?

Accede a phpMyAdmin.
Selecciona tu base de datos.
Haz clic en la pestaña Importar.
Haz clic en Seleccionar archivo y elige tu archivo .sql de la copia de seguridad.
Haz clic en Continuar o Ejecutar. Dependiendo del tamaño, puede tardar varios minutos.

[WARNING]: Restaurar una base de datos sobrescribirá todos los datos actuales. Cualquier pedido, producto o cliente nuevo que se haya creado desde la copia de seguridad se perderá.

Preguntas Frecuentes (FAQ) sobre errores de base de datos

¿Por qué veo el error después de cambiar de hosting?

Es el motivo más común. Al migrar tu tienda, los datos de conexión (servidor, nombre de la base, usuario y contraseña) cambian. Debes actualizar el archivo config/settings.inc.php con los nuevos datos que te proporcione tu nuevo hosting.

¿Puedo solucionar este error sin perder datos?

Sí, en el 90% de los casos. Los pasos 1 al 6 de esta guía no implican pérdida de datos. Solo el paso 8 (restaurar copia de seguridad) conlleva una pérdida potencial, y es el último recurso.

¿Cada cuánto debo hacer una copia de seguridad de mi base de datos?

Depende del volumen de ventas. Para una tienda pequeña, una copia semanal es suficiente. Para una tienda activa, es recomendable una copia diaria automática. Muchos paneles de hosting (como Syspanel) ofrecen esta funcionalidad.

¿Qué hago si el error aparece solo en el back-office?

A veces el front-office (la tienda visible) funciona, pero el back-office (panel de admin) da error. Esto puede deberse a un problema con una tabla específica o un módulo. Intenta acceder al back-office desde un navegador en modo incógnito. Si sigue fallando, aplica los mismos pasos de reparación desde phpMyAdmin.

Conclusión

Enfrentarse a un error base datos PrestaShop puede ser estresante, pero como has visto, las soluciones están al alcance de tu mano. La clave está en la calma y en seguir los pasos de forma metódica.

Empieza siempre por lo más básico: revisar las credenciales en settings.inc.php y comprobar que el servidor MySQL esté activo. Si eso no funciona, la reparación desde phpMyAdmin suele ser el remedio milagroso. Y si todo lo demás falla, tu copia de seguridad te devolverá la sonrisa.

Si después de intentarlo todo el problema persiste, no dudes en contactar con el soporte técnico de tu hosting. Diles exactamente qué pasos has seguido; te lo agradecerán y te ayudarán más rápido. ¡Tu tienda volverá a estar online en poco tiempo!