Soluciona errores frecuentes de PrestaShop desde Syspanel

Si tienes una tienda online en PrestaShop, es probable que en algún momento te hayas encontrado con pantallas en blanco, mensajes de error o problemas de conexión con la base de datos. No te preocupes, es más común de lo que crees. La mayoría de estos errores tienen solución y, si gestionas tu hosting a través de Syspanel (el panel de control que antes conocías como HestiaCP, accesible por el puerto 2106), puedes resolverlos tú mismo sin necesidad de ser un experto en programación.

En este artículo vamos a recorrer los errores PrestaShop Syspanel más habituales, desde el temido error 500 hasta los problemas con la base de datos. Te explicaré paso a paso cómo solucionarlos, con un lenguaje claro y sencillo. Al final, tendrás una guía práctica para mantener tu tienda funcionando sin sobresaltos.

Error 500 en PrestaShop: la pantalla blanca de la muerte

El error 500 es probablemente el más frustrante porque, a simple vista, no te da ninguna pista sobre qué ha fallado. Simplemente ves una página en blanco o un mensaje genérico. En realidad, este error indica que algo salió mal en el servidor, pero PrestaShop no puede mostrar el detalle por seguridad.

¿Por qué ocurre el error 500 en PrestaShop?

Las causas más frecuentes son:

Un módulo incompatible después de una actualización.
Límite de memoria PHP excedido (memory_limit).
Problemas con el archivo .htaccess (sobre todo en migraciones).
Errores en el archivo settings.inc.php (conexión a la base de datos).
Versión de PHP incorrecta para la versión de PrestaShop que usas.

Cómo solucionar el error 500 PrestaShop desde Syspanel

Para solucionar error 500 PrestaShop, lo primero es activar el modo debug de PrestaShop. Esto te mostrará el error real en pantalla.

Accede a Syspanel: Abre tu navegador y escribe https://tudominio.com:2106. Inicia sesión con tus credenciales.
Ve al gestor de archivos: Dentro de Syspanel, busca la opción "Administrador de archivos" o "File Manager". Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html).
Edita el archivo config/defines.inc.php: Localiza este archivo y ábrelo con el editor de texto de Syspanel.
Cambia el modo debug: Busca la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Guarda los cambios.
Recarga tu tienda: Ahora, en lugar de la pantalla blanca, verás un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size exhausted").

[INFO] Una vez resuelto el problema, recuerda volver a poner el modo debug en false para que los clientes no vean errores internos.

Aumentar el límite de memoria PHP

Si el error indica que se agotó la memoria, puedes aumentarla desde Syspanel:

En Syspanel, ve a "Ajustes de servidor" o "PHP Settings".
Busca la opción memory_limit y cámbiala a un valor mayor, por ejemplo 256M o 512M.
Guarda y reinicia el servicio PHP desde el mismo panel.

Problemas con la base de datos en PrestaShop

Otro de los grandes dolores de cabeza es el mensaje "Error de conexión a la base de datos" o directamente "PrestaShop base de datos error". Esto suele aparecer después de mover la tienda a otro servidor, al cambiar la contraseña de la base de datos o por corrupción de tablas.

Síntomas comunes de un error de base de datos

La tienda carga pero las páginas de producto están vacías.
Aparece el mensaje "Link to database cannot be established".
Error al intentar acceder al back office.
Advertencias sobre tablas que faltan o están corruptas.

Cómo solucionar un error de base de datos en PrestaShop con Syspanel

1. Verificar los datos de conexión

El primer paso es asegurarte de que PrestaShop está usando los datos correctos de la base de datos.

En Syspanel, ve al gestor de archivos y abre la carpeta public_html.
Localiza el archivo config/settings.inc.php (en PrestaShop 1.6 y anteriores) o app/config/parameters.php (en PrestaShop 1.7+).
Revisa que los valores de database_host, database_name, database_user y database_password coincidan con los que tienes en Syspanel.
Si no recuerdas la contraseña, puedes generarla de nuevo desde Syspanel en la sección "Bases de datos".

[WARNING] Nunca dejes la contraseña de la base de datos en blanco o uses contraseñas como "123456". Pon una segura.

2. Reparar tablas corruptas

Si la conexión es correcta pero sigues viendo errores, es posible que algunas tablas estén dañadas.

En Syspanel, accede a "phpMyAdmin" (suele estar en la sección de bases de datos).
Selecciona la base de datos de tu PrestaShop.
Marca todas las tablas (puedes usar el checkbox superior).
En el menú desplegable de acciones, elige "Reparar tabla".
Espera a que termine el proceso. Si hay tablas que no se reparan, intenta con "Optimizar tabla".

3. Restaurar una copia de seguridad

Si la reparación no funciona, siempre puedes restaurar una copia de seguridad reciente. Desde Syspanel puedes hacerlo fácilmente:

Ve a "Backups" o "Copias de seguridad".
Elige la copia más reciente de tu base de datos.
Haz clic en "Restaurar". El proceso puede tardar unos minutos.

[TIP] Programa copias de seguridad automáticas desde Syspanel. Así siempre tendrás un punto de recuperación.

Errores de permisos de archivos y carpetas

A veces PrestaShop no puede escribir en ciertas carpetas (por ejemplo, para subir imágenes o generar archivos de caché). Esto se manifiesta con errores como "No se puede escribir en la carpeta cache" o "Error al subir la imagen".

Cómo arreglar los permisos desde Syspanel

En el gestor de archivos de Syspanel, selecciona toda la carpeta de tu tienda (normalmente public_html).
Haz clic derecho y elige "Cambiar permisos".
Para carpetas, establece 755 (rwxr-xr-x). Para archivos, 644 (rw-r--r--).
Marca la opción "Aplicar a subcarpetas y archivos".
Guarda los cambios.

[INFO] No uses permisos 777 a no ser que sea estrictamente necesario y por poco tiempo. Es un riesgo de seguridad.

El error del carrito que se vacía solo

¿Has notado que los clientes añaden productos al carrito, pero al pasar a la siguiente página el carrito aparece vacío? Esto suele deberse a problemas con las cookies o la sesión de PHP.

Solución paso a paso

Limpia la caché de PrestaShop: Desde el back office, ve a Parámetros avanzados > Rendimiento y haz clic en "Limpiar caché".
Regenera el archivo .htaccess: En la misma sección de rendimiento, busca "Regenerar archivo .htaccess".
Verifica la configuración de cookies en Syspanel: En Syspanel, ve a "Ajustes de PHP" y asegúrate de que session.save_path esté configurado correctamente (suele ser /tmp).
Comprueba la URL de la tienda: En el back office, en Parámetros de tienda > Tráfico y SEO, revisa que la URL base sea correcta y no tenga www si no lo usas (o viceversa).

Errores al actualizar PrestaShop o módulos

Actualizar PrestaShop o un módulo puede romper la tienda si no se hace con cuidado. Los errores más típicos son:

Pantalla blanca después de la actualización.
Módulos que dejan de funcionar.
Problemas con el tema (plantilla).

Cómo evitar problemas al actualizar

Siempre haz una copia de seguridad completa (archivos + base de datos) desde Syspanel antes de actualizar.
Actualiza primero en un entorno de pruebas si es posible.
Desactiva todos los módulos no esenciales antes de la actualización.
Usa el modo mantenimiento desde el back office para que los clientes no vean errores.

Si ya tienes el error, puedes restaurar la copia de seguridad desde Syspanel y volver a intentarlo con más cuidado.

Errores de URL amigable (mod_rewrite)

Si al activar las URLs amigables en PrestaShop te encuentras con un error 404 en todas las páginas excepto la principal, el problema suele ser el archivo .htaccess.

Solución desde Syspanel

En el gestor de archivos, busca el archivo .htaccess en la raíz de tu tienda.
Si no existe, puedes generarlo desde el back office: Parámetros avanzados > Rendimiento > Regenerar archivo .htaccess.
Si existe pero no funciona, renómbralo a .htaccess_old y luego regenéralo desde el back office.
Asegúrate de que el módulo mod_rewrite de Apache esté activado en Syspanel (en la sección de Ajustes de servidor web).

El error "500 Internal Server Error" después de instalar un módulo

Este es un clásico. Instalas un módulo nuevo, lo activas y ¡puf! todo se rompe.

Cómo desactivar el módulo desde Syspanel

Si no puedes acceder al back office, puedes desactivar el módulo directamente desde la base de datos:

Ve a phpMyAdmin desde Syspanel.
Selecciona la base de datos de PrestaShop.
Busca la tabla ps_module (o prestashop_module según el prefijo).
Localiza el módulo problemático (por el nombre) y cambia su estado active de 1 a 0.
Guarda el cambio. Ahora podrás volver a entrar al back office.

[WARNING] Si no te sientes cómodo editando la base de datos, mejor pide ayuda a tu agencia de hosting o a un desarrollador.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop da error 500 después de cambiar la versión de PHP?

Porque algunas versiones de PrestaShop no son compatibles con PHP 8.0 o superior. Vuelve a una versión anterior (PHP 7.4 suele ser la más segura) desde Syspanel en "Ajustes de PHP".

¿Cómo sé qué versión de PHP uso en Syspanel?

En Syspanel, ve a "Ajustes de servidor" o "PHP Settings". Allí verás la versión actual y podrás cambiarla fácilmente.

¿Puedo restaurar una copia de seguridad de PrestaShop desde Syspanel sin perder datos?

Sí, pero ten en cuenta que la restauración reemplazará todos los archivos y la base de datos por los de la copia. Cualquier cambio posterior se perderá. Por eso es importante hacer copias con frecuencia.

¿Qué hago si el error persiste después de seguir todos los pasos?

Si has probado todo y el error sigue, contacta con el soporte técnico de tu hosting. Desde Syspanel puedes abrir un ticket de soporte directamente. A veces el problema está en el servidor y no en tu tienda.

Conclusión

Los errores PrestaShop Syspanel pueden parecer abrumadores al principio, pero con esta guía tienes las herramientas para resolver la mayoría de ellos por ti mismo. Recuerda que Syspanel (puerto 2106) te da acceso directo a archivos, bases de datos y ajustes del servidor, lo que facilita mucho el diagnóstico y la solución.

La clave está en actuar con calma, seguir los pasos uno a uno y, sobre todo, hacer copias de seguridad periódicas. Así, cualquier error se convierte en un pequeño contratiempo, no en una catástrofe.

Espero que este artículo te haya sido útil. Si tienes alguna duda concreta, déjala en los comentarios y la responderé encantado. ¡Buena suerte con tu tienda!