Problemas de base de datos en PrestaShop con DirectAdmin | Soluciones

¡Hola! Soy tu técnico de soporte amigable. Si tienes una tienda online con PrestaShop y estás usando DirectAdmin como panel de control, es muy probable que en algún momento te topes con algún error de base de datos. No te preocupes, es más común de lo que parece y, con esta guía paso a paso, podrás solucionar la mayoría de los problemas tú mismo. Vamos a ello.

¿Por qué aparecen errores de base de datos en PrestaShop?

PrestaShop guarda toda la información importante de tu tienda (productos, clientes, pedidos, configuraciones) en una base de datos. Si algo falla en esa base de datos, tu tienda puede mostrar mensajes de error, no cargar o incluso dejar de funcionar. Las causas más comunes son:

Conexión incorrecta: Los datos de acceso (usuario, contraseña, nombre de la base de datos) no coinciden con los que tiene configurados PrestaShop.
Servidor de base de datos caído: El servicio MySQL o MariaDB no está funcionando en tu servidor.
Corrupción de tablas: Las tablas de la base de datos se han dañado, a menudo por cortes de energía, cierres bruscos o errores al instalar módulos.
Límite de conexiones: Demasiadas conexiones simultáneas a la base de datos, lo que la bloquea.
Versión incompatible: La versión de PHP de tu servidor no es compatible con la versión de PrestaShop o con los requisitos de la base de datos.

Herramientas que vamos a usar en DirectAdmin

DirectAdmin nos ofrece todo lo necesario para gestionar y reparar nuestra base de datos sin necesidad de ser un experto. Usaremos principalmente:

phpMyAdmin: Una herramienta web para administrar bases de datos MySQL/MariaDB de forma gráfica.
MySQL/MariaDB Manager: Una sección en DirectAdmin para ver el estado del servidor de bases de datos.

Paso 1: Identificar el error exacto

Lo primero es saber qué está pasando. Cuando tu tienda muestre un error, fíjate bien en el mensaje. Los más comunes son:

"Error de conexión a la base de datos"
"Tabla 'xxxx' no existe"
"El servidor MySQL no está funcionando"
"Too many connections"
"General error: 2006 MySQL server has gone away"

[TIP] Anota el mensaje de error exacto o haz una captura de pantalla. Esto te ayudará a buscar la solución más precisa.

Paso 2: Verificar que el servicio de base de datos esté activo

Este es el primer paso y el más sencillo. A veces, el servidor de bases de datos se detiene por una actualización o un fallo temporal.

Accede a tu panel de DirectAdmin.
Busca la sección "Administración de cuentas" o "Servicios" (puede variar ligeramente según la versión).
Haz clic en "MySQL/MariaDB Manager" o en "Servicios MySQL".
Verás un estado que indica si el servicio está "Corriendo" (Running) o "Detenido" (Stopped).

Si está detenido, simplemente haz clic en el botón "Iniciar" (Start). Espera unos segundos y vuelve a comprobar el estado. Ahora debería aparecer como "Corriendo". Vuelve a tu tienda y comprueba si el error ha desaparecido.

[WARNING] Si el servicio se detiene con frecuencia, puede ser un problema de falta de recursos (memoria RAM) en tu servidor. Contacta con tu proveedor de hosting para revisarlo.

Paso 3: Comprobar los datos de conexión en PrestaShop

Si el servicio está activo pero el error persiste, es probable que los datos de conexión de PrestaShop no sean correctos. Esto puede pasar si cambiaste la contraseña de la base de datos o si la configuración se corrompió.

Accede a tu panel de DirectAdmin.
Ve a la sección "Archivos" y haz clic en "Administrador de archivos".
Navega hasta la carpeta raíz de tu tienda PrestaShop (normalmente es public_html o el nombre de tu dominio).
Busca el archivo app/config/parameters.php (en PrestaShop 1.7 y 8.x) o config/settings.inc.php (en PrestaShop 1.6).
Haz clic derecho sobre el archivo y selecciona "Editar".
Busca las líneas que contienen los siguientes parámetros:
- database_host (normalmente es 'localhost' o '127.0.0.1')
- database_name (el nombre de tu base de datos)
- database_user (el usuario de la base de datos)
- database_password (la contraseña del usuario)
Ahora, ve a DirectAdmin y busca la sección "MySQL Management" o "Base de datos MySQL". Allí podrás ver el nombre de tu base de datos, el usuario y podrás cambiar la contraseña si es necesario.
Compara los datos del archivo parameters.php o settings.inc.php con los que ves en DirectAdmin. Asegúrate de que el usuario y la contraseña sean exactamente los mismos.
Si la contraseña en el archivo no coincide con la de DirectAdmin, cámbiala en el archivo por la correcta y guarda los cambios.

[INFO] Nunca uses espacios o caracteres especiales extraños en los nombres de usuario o contraseñas. Si tienes dudas, desde DirectAdmin puedes generar una nueva contraseña segura y actualizarla tanto en el panel como en el archivo de configuración.

Paso 4: Reparar tablas de la base de datos con phpMyAdmin

Este es el paso estrella para solucionar la mayoría de los errores de base de datos PrestaShop. Las tablas se pueden corromper y phpMyAdmin tiene una herramienta para repararlas.

En tu panel de DirectAdmin, busca y haz clic en "phpMyAdmin" (suele estar en la sección de "Base de datos" o "MySQL Management").
Se abrirá una nueva ventana. A la izquierda, verás una lista de bases de datos. Haz clic en el nombre de la base de datos de tu PrestaShop (el mismo que viste en el paso anterior).
Verás una lista de todas las tablas de tu base de datos. Selecciona todas. Para ello, marca la casilla de la parte inferior de la lista que dice "Seleccionar todo" o "Check All".
En el menú desplegable que aparece debajo de la lista de tablas (donde pone "Con selección:" o "With selected:"), elige la opción "Reparar tabla" (Repair table).
phpMyAdmin ejecutará el proceso y te mostrará un mensaje de éxito o de error. Si todo va bien, verás algo como "La operación de reparación se ha completado correctamente".

[TIP] Es una buena práctica hacer esto una vez al mes como mantenimiento preventivo. Si tu tienda es muy grande, puedes hacerlo por partes, seleccionando solo unas 50 tablas cada vez para no sobrecargar el servidor.

Paso 5: Optimizar la base de datos (para que tu tienda vuele)

Además de reparar, puedes optimizar las tablas para que ocupen menos espacio y las consultas sean más rápidas. Esto ayuda a prevenir futuros errores.

Sigue los pasos 1 y 2 del paso anterior para entrar a phpMyAdmin y seleccionar tu base de datos.
Selecciona todas las tablas de nuevo.
En el menú desplegable, elige la opción "Optimizar tabla" (Optimize table).
Espera a que termine el proceso. Verás un mensaje de confirmación.

[INFO] La optimización no elimina datos, solo reorganiza el espacio físico en el disco para que las consultas sean más eficientes.

Errores específicos y sus soluciones rápidas

"Too many connections" (Demasiadas conexiones)

Este error significa que tu base de datos ha alcanzado el límite de conexiones simultáneas.

Solución: Esto suele ser un síntoma de que un módulo o un script está haciendo demasiadas consultas. Intenta desactivar módulos recién instalados. Si el problema persiste, contacta con tu hosting para que aumenten el límite de conexiones.

"MySQL server has gone away" (El servidor MySQL ha desaparecido)

Este error suele ocurrir cuando se intenta ejecutar una consulta muy grande o cuando el tiempo de espera de conexión es muy corto.

Solución: Aumenta el valor de max_allowed_packet en la configuración de MySQL. Esto no se puede hacer desde DirectAdmin fácilmente, así que lo mejor es que le pidas a tu soporte técnico que lo revise o que suba el límite a 128MB o 256MB.

Error de versión de PHP

PrestaShop 1.6 ya no es compatible con PHP 8.x, y PrestaShop 1.7 necesita al menos PHP 7.1.

Solución: En DirectAdmin, ve a la sección "PHP Selector" o "Administrar versiones de PHP". Allí podrás cambiar la versión de PHP de tu dominio. Asegúrate de elegir una versión compatible con tu PrestaShop.

Mantenimiento preventivo: la clave del éxito

Para evitar futuros dolores de cabeza, te recomiendo seguir estas buenas prácticas:

Haz copias de seguridad semanales: DirectAdmin tiene una herramienta de backup. Programa una copia de seguridad de tu base de datos y archivos cada semana.
Actualiza PrestaShop y los módulos: Las versiones antiguas tienen bugs que pueden causar errores de base de datos.
No instales módulos de fuentes dudosas: Un módulo mal codificado puede corromper tu base de datos.
Revisa los logs de errores: En DirectAdmin, puedes ver los logs de errores de tu servidor. Busca errores relacionados con MySQL para anticiparte a los problemas.

Preguntas Frecuentes (FAQ)

¿Qué hago si no puedo acceder a DirectAdmin?

Contacta con tu proveedor de hosting inmediatamente. Ellos son los únicos que pueden restablecer tu acceso.

¿Perderé mis datos si reparo la base de datos?

No. La reparación de tablas no elimina datos. Solo corrige estructuras dañadas. La optimización tampoco borra información.

¿Cómo sé qué versión de PrestaShop tengo?

Puedes verlo en el back office de tu tienda, en la parte inferior de la página de inicio, o en el archivo config/defines.inc.php (busca la línea _PS_VERSION_).

¿Puedo usar Syspanel (HestiaCP) para lo mismo?

Sí, si tu proveedor usa Syspanel (HestiaCP), el proceso es muy similar. Accede a tu panel Syspanel a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Dentro, busca las herramientas de "Base de datos" y "phpMyAdmin". Los pasos para reparar u optimizar son los mismos.

[WARNING] Si no estás seguro de algo, no modifiques archivos ni bases de datos sin hacer una copia de seguridad antes. Un error puede dejar tu tienda inaccesible.

Espero que esta guía te haya sido de gran ayuda. Con un poco de paciencia y siguiendo estos pasos, podrás resolver la mayoría de los errores de base de datos PrestaShop DirectAdmin por ti mismo. ¡Tu tienda volverá a funcionar en poco tiempo! Si el problema persiste, no dudes en contactar a tu soporte técnico de hosting.