Solucionar errores de base de datos PrestaShop en Plesk

¿Tu tienda PrestaShop se ha quedado congelada mostrando un mensaje de error de base de datos? No te preocupes, es uno de los problemas más comunes entre los usuarios de PrestaShop, especialmente al actualizar módulos, cambiar de servidor o tras una mala conexión. En esta guía completa, escrita especialmente para ti como técnico de soporte amigable, te explicaré paso a paso cómo identificar y reparar estos errores utilizando las herramientas que tienes en tu panel de control Plesk.

Vamos a desglosar todo lo que necesitas saber: desde entender qué significa un error de base de datos PrestaShop, hasta usar phpMyAdmin PrestaShop para reparar tablas dañadas y optimizar tu tienda. Todo explicado de forma clara, sin tecnicismos innecesarios.

¿Qué es un error de base de datos en PrestaShop y por qué ocurre?

Imagina que la base de datos es el cerebro de tu tienda: guarda productos, clientes, pedidos, configuraciones... Cuando algo falla en ese cerebro, PrestaShop no puede funcionar. Los errores más típicos que verás son mensajes como "Error de conexión a la base de datos", "Tabla no existe" o "MySQL ha desaparecido".

Las causas más frecuentes incluyen:

Actualizaciones incompletas de PrestaShop, módulos o temas.
Cortes de energía o conexión mientras se escribía en la base de datos.
Corrupción de tablas por uso excesivo o falta de mantenimiento.
Configuración incorrecta de los parámetros de conexión (usuario, contraseña, servidor).
Límites de recursos del servidor (memoria, conexiones simultáneas).

[INFO] La mayoría de estos problemas se pueden resolver sin perder datos si actúas con calma y sigues los pasos adecuados. No te asustes, estamos aquí para ayudarte.

Primeros pasos: identifica el error exacto

Antes de lanzarte a reparar, necesitas saber qué está pasando exactamente. PrestaShop suele mostrar un mensaje en pantalla, pero a veces es muy genérico. Aquí te enseño a obtener más detalles.

Revisa los logs de error de PrestaShop

Accede a tu panel de Plesk y busca la sección de archivos. Dentro de la carpeta de tu tienda (normalmente httpdocs o public_html), localiza la carpeta var/logs (en PrestaShop 1.7+) o log (en versiones anteriores). Abre el archivo más reciente con extensión .log. Busca líneas que contengan "SQL", "database" o "PDO".

Consulta el error directamente en el navegador

Si ves un mensaje como "Error de conexión a la base de datos", puede que el problema sea de configuración. Si ves "Tabla 'ps_xxx' no existe", entonces es una tabla corrupta o faltante.

[TIP] Anota el nombre exacto de la tabla que falla (por ejemplo, ps_product o ps_customer). Te será útil más adelante.

Reparar la base de datos desde Plesk usando phpMyAdmin

Aquí viene la parte práctica. Plesk incluye una herramienta llamada phpMyAdmin PrestaShop (o simplemente phpMyAdmin) que te permite gestionar directamente la base de datos. Vamos a usarla para reparar tablas dañadas.

Accede a phpMyAdmin desde Plesk

Inicia sesión en tu panel de Plesk.
Ve a la sección Bases de datos (suele estar en el menú de la izquierda o en "Sitios web y dominios").
Busca la base de datos asociada a tu tienda PrestaShop (normalmente se llama algo como prestashop_db o tu_dominio_presta).
Haz clic en el enlace phpMyAdmin que aparece al lado. Se abrirá una nueva pestaña con la interfaz de phpMyAdmin.

Repara tablas corruptas paso a paso

Una vez dentro de phpMyAdmin, sigue estos pasos:

En el panel izquierdo, selecciona tu base de datos (haz clic en su nombre). Verás una lista de todas las tablas.
Marca la casilla de la tabla que está dando error (por ejemplo, ps_product). Si no sabes cuál es, puedes seleccionar todas las tablas marcando la casilla superior.
En el menú desplegable que aparece debajo de la lista (junto a "Con seleccionados:"), elige Reparar tabla.
Haz clic en Continuar. phpMyAdmin intentará reparar la tabla automáticamente.

[WARNING] Si tienes muchas tablas, reparar todas puede tomar unos segundos. No cierres la ventana ni hagas clic en otro sitio mientras se ejecuta.

Verifica el resultado

Después de la reparación, verás un mensaje como "La tabla se ha reparado correctamente" o "Operación completada". Si aparece algún error, anótalo. A veces es necesario repetir el proceso o usar una herramienta más avanzada.

Optimizar la base de datos para evitar futuros errores

Reparar es solo el primer paso. Para mantener tu tienda saludable, es buena práctica optimizar la base de datos periódicamente. Esto libera espacio y mejora el rendimiento.

Cómo optimizar desde phpMyAdmin

En la misma pantalla de phpMyAdmin, selecciona todas las tablas (casilla superior).
En el menú desplegable, elige Optimizar tabla.
Haz clic en Continuar. Verás un resumen de cada tabla y su estado.

[INFO] La optimización no borra datos, solo reorganiza el almacenamiento interno. Es segura y recomendable hacerla una vez al mes.

Solucionar errores de conexión a la base de datos

A veces el problema no es una tabla corrupta, sino que PrestaShop no puede conectar con la base de datos. Esto suele deberse a cambios en la configuración.

Revisa el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión en un archivo llamado app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en versiones anteriores). Accede a tu tienda a través de FTP o del administrador de archivos de Plesk y busca ese archivo.

Dentro verás líneas como:

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_db',
'database_user' => 'usuario_db',
'database_password' => 'contraseña_db',

Asegúrate de que estos datos coincidan con los que tienes en Plesk. Si has cambiado la contraseña recientemente, actualízala aquí.

[TIP] Si no recuerdas la contraseña, en Plesk puedes ir a Bases de datos, seleccionar tu base y hacer clic en Cambiar contraseña. Luego actualiza el archivo de configuración.

Prueba la conexión manualmente

Desde phpMyAdmin, intenta acceder con el usuario y contraseña que tienes en el archivo. Si no puedes, el problema está en las credenciales. Si puedes, entonces el error puede ser de permisos o de que el servidor de bases de datos no responde.

Restaurar una copia de seguridad de la base de datos

Si la reparación no funciona o los errores son muy graves (por ejemplo, la base de datos está completamente corrupta), lo mejor es restaurar una copia de seguridad reciente. Siempre deberías tener copias automáticas en tu hosting.

Desde Plesk: restaurar una base de datos

Ve a Bases de datos en Plesk.
Selecciona tu base de datos y haz clic en Copias de seguridad (o Backups).
Elige una copia de seguridad anterior a la fecha del error y haz clic en Restaurar.
Confirma la acción. Se sobrescribirá la base actual con la copia.

[WARNING] Restaurar una copia de seguridad borrará cualquier cambio realizado después de la fecha de esa copia. Asegúrate de que sea la más reciente posible y que no pierdas pedidos o clientes importantes.

Si no tienes copia de seguridad en Plesk

Puedes usar una copia que hayas descargado manualmente. En ese caso, ve a Bases de datos, selecciona tu base y haz clic en Importar. Sube el archivo .sql y ejecuta la importación. Ten paciencia, puede tardar varios minutos.

Errores comunes y sus soluciones rápidas

Aquí tienes una lista de errores típicos con sus remedios, para que puedas actuar rápido.

"Table 'ps_xxx' doesn't exist"

Causa: La tabla se ha borrado o no se creó correctamente durante una actualización.
Solución: Repara la tabla desde phpMyAdmin. Si no funciona, intenta ejecutar una consulta SQL para recrearla: CREATE TABLE IF NOT EXISTS ps_xxx (...); (necesitas la estructura original, que puedes obtener de una copia de seguridad o de la documentación de PrestaShop).

"MySQL server has gone away"

Causa: El servidor de bases de datos se ha desconectado por inactividad o por un límite de tiempo.
Solución: Aumenta el valor de wait_timeout en la configuración de MySQL (si tienes acceso). Si no, contacta con tu proveedor de hosting. También puedes optimizar consultas pesadas.

"PDOException: SQLSTATE[HY000] [2002] Connection refused"

Causa: El servidor de bases de datos no está corriendo o el puerto está bloqueado.
Solución: Verifica que el servicio MySQL esté activo en Plesk (ve a Herramientas y ajustes > Servicios). Si está apagado, enciéndelo. Si el problema persiste, contacta con soporte.

"Error de conexión a la base de datos" en la instalación

Causa: Datos incorrectos en el asistente de instalación.
Solución: Revisa que el nombre de la base, usuario y contraseña sean correctos. Asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).

Preguntas frecuentes (FAQ)

¿Puedo perder datos al reparar la base de datos?
No, la reparación solo corrige índices y estructuras dañadas. No borra información. La optimización tampoco elimina datos.

¿Con qué frecuencia debo optimizar la base de datos?
Una vez al mes es suficiente. Si tu tienda tiene mucho tráfico, puedes hacerlo cada 15 días.

¿Qué hago si phpMyAdmin no abre o da error?
Prueba a cerrar sesión en Plesk y volver a entrar. Si el problema persiste, contacta con tu proveedor de hosting. A veces el servicio de MySQL necesita reiniciarse.

¿El error de base de datos puede deberse a un plugin o módulo?
Sí, especialmente módulos mal codificados o desactualizados. Si el error apareció tras instalar un módulo, desactívalo desde el archivo de configuración (renombrando la carpeta del módulo en /modules).

¿Necesito conocimientos de SQL para reparar?
No, con los pasos que te he dado (reparar desde phpMyAdmin) es suficiente. Solo si el error es muy específico necesitarás ejecutar consultas, pero siempre puedes pedir ayuda a tu técnico de soporte.

Consejos finales para mantener tu tienda segura

Haz copias de seguridad automáticas en Plesk al menos una vez por semana.
Actualiza PrestaShop y los módulos solo desde el backoffice y con calma, sin prisas.
No interrumpas nunca una actualización o una importación de base de datos.
Revisa los logs de tu tienda cada cierto tiempo para detectar problemas antes de que crezcan.
Si usas Syspanel (antes llamado HestiaCP), recuerda que el puerto de acceso es el 2106. En ese panel también puedes gestionar bases de datos con herramientas similares.

[INFO] Recuerda que siempre puedes contar con el soporte técnico de tu hosting si los pasos anteriores no resuelven el problema. Nosotros estamos aquí para ayudarte.

Espero que esta guía te haya sido de gran ayuda. Los errores de base de datos en PrestaShop pueden ser frustrantes, pero con las herramientas adecuadas (como Plesk y phpMyAdmin) y un poco de paciencia, la mayoría se solucionan en pocos minutos. ¡Tu tienda volverá a funcionar como nueva!