Solución a errores comunes en PrestaShop (Syspanel)

¿Por qué mi tienda PrestaShop da errores y cómo los soluciono con Syspanel?

Si tienes una tienda online con PrestaShop, es muy probable que en algún momento te hayas encontrado con una pantalla en blanco, un mensaje de error 500 o un problema extraño al intentar acceder al panel de administración. No te preocupes, no eres el único. Estos fallos son mucho más comunes de lo que parece y, en la gran mayoría de los casos, tienen una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

En esta guía extensa y práctica, vamos a desglosar los errores PrestaShop más frecuentes y te enseñaremos paso a paso cómo solucionar errores PrestaShop utilizando las herramientas que tienes a tu disposición, especialmente a través de tu panel de control Syspanel (anteriormente conocido como HestiaCP). Recuerda que puedes acceder a Syspanel a través del puerto 2106 (por ejemplo, https://tu-dominio.com:2106).

Vamos a empezar por el principio para que entiendas de dónde vienen estos problemas y cómo atajarlos de raíz.

Entendiendo la raíz de los problemas: El corazón de PrestaShop

Antes de lanzarnos a apagar fuegos, es fundamental entender por qué ocurren estos fallos. PrestaShop es un software complejo que depende de varios elementos para funcionar:

1. PHP: El lenguaje de programación en el que está escrito. Si la versión de PHP no es compatible o está mal configurada, todo se rompe.
2. Base de datos (MySQL/MariaDB): Donde se almacenan tus productos, pedidos y clientes. Si la conexión falla o la base de datos está corrupta, la tienda no carga.
3. Archivos del núcleo (Core): Los archivos que forman el propio PrestaShop. Si se corrompen o faltan, aparecen errores fatales.
4. Permisos de archivos: PrestaShop necesita permisos de lectura y escritura para funcionar. Si están mal configurados, no podrá crear archivos de caché o de configuración.

La buena noticia es que la mayoría de los errores comunes se pueden resolver gestionando estos cuatro pilares desde tu panel Syspanel. Vamos a ver los casos más típicos.

El Temido "PrestaShop Error 500" o "Error Interno del Servidor"

Este es, sin duda, el error más común y frustrante. Verás una página en blanco o un mensaje genérico de error 500. No te asustes, en el 90% de los casos se debe a un problema de permisos o de caché.

Solución Paso a Paso para el Error 500

1. Accede a Syspanel: Abre tu navegador y ve a https://tu-dominio.com:2106.
2. Inicia sesión: Introduce tus credenciales de administrador.
3. Navega a "Archivos": En el menú lateral, busca la sección que dice "Archivos" o "Administrador de archivos". Haz clic para abrirlo. Te llevará al directorio raíz de tu cuenta de hosting.
4. Localiza la carpeta de tu tienda: Dentro del administrador de archivos, busca la carpeta donde tienes instalado PrestaShop (suele ser public_html o una subcarpeta como tienda o prestashop).
5. Ajusta los permisos de las carpetas: Esta es la clave. A la izquierda, verás el árbol de directorios. Haz clic derecho sobre la carpeta principal de tu tienda y selecciona "Permisos". Asegúrate de que las carpetas tengan permiso 755 y los archivos 644. Puedes hacerlo de forma masiva seleccionando todo y aplicando estos valores. Esto es crucial para que PrestaShop pueda leer y escribir sin problemas.
6. Limpia la caché manualmente: A veces, la caché de PrestaShop se corrompe y causa el error 500. Para limpiarla, dentro del administrador de archivos, navega a /var/cache/ (o /var/cache/prod y /var/cache/dev en versiones más nuevas). Dentro de estas carpetas, borra todos los archivos que haya, pero no borres la carpeta en sí. Si no ves nada, activa la opción de "Mostrar archivos ocultos" en la configuración del administrador de archivos.
7. Verifica la versión de PHP: Vuelve a Syspanel y busca la sección "Web" o "Dominios". Haz clic en el dominio de tu tienda. Verás una opción para "PHP" o "Versión de PHP". Asegúrate de tener una versión compatible con tu PrestaShop (por ejemplo, PHP 7.4, 8.0 o 8.1, dependiendo de la versión de tu tienda). Si no estás seguro, prueba a cambiar a una versión anterior y ver si el error desaparece.

[TIP] Si el error persiste después de esto, el problema podría ser un módulo o theme defectuoso. Puedes renombrar la carpeta /modules a /modules_bak temporalmente para ver si la tienda carga. Si lo hace, el problema es un módulo. Luego, ve renombrando los módulos de uno en uno para encontrar al culpable.

El Error de "Base de datos no encontrada" o "Error de conexión a la base de datos"

Este error es más específico. PrestaShop no puede conectarse a su base de datos, lo que significa que no puede mostrar tu catálogo.

Solución Paso a Paso para el Error de Base de Datos

1. Accede a Syspanel (puerto 2106).
2. Ve a la sección "Bases de Datos": En el menú lateral, busca "Bases de Datos" o "Base de datos MySQL".
3. Revisa el estado de la base de datos: Asegúrate de que la base de datos que usa tu PrestaShop esté activa y no haya sido suspendida.
4. Comprueba las credenciales: A veces, sin querer, se cambia la contraseña de la base de datos. PrestaShop guarda esa información en un archivo llamado parameters.php dentro de la carpeta /app/config/. Abre este archivo desde el administrador de archivos de Syspanel y verifica que el nombre de la base de datos, el usuario y la contraseña coincidan con los que ves en la sección "Bases de Datos" de Syspanel.
5. Reinicia el servicio de base de datos: En Syspanel, busca la opción para reiniciar los servicios. Normalmente está en la sección de "Servicios" o en la barra superior. Busca "MySQL" o "MariaDB" y haz clic en el botón de reiniciar.

[WARNING] Si no estás seguro de lo que estás haciendo, no modifiques el archivo parameters.php directamente. Un cambio incorrecto puede dejar tu tienda completamente inaccesible. Si tienes dudas, contacta con tu proveedor de hosting.

La Pantalla Blanca o "Error Fatal de PHP"

Este error es un poco más técnico, pero suele aparecer cuando hay un conflicto de memoria o un problema con un módulo.

Solución Paso a Paso para el Error de PHP

1. Aumenta el límite de memoria de PHP: Este es el culpable más común. PrestaShop necesita un mínimo de 256 MB de memoria para funcionar bien. En Syspanel, ve a la sección "Web" o "Dominios", selecciona tu dominio y busca la opción "Configuración PHP" o "PHP-FPM". Dentro, busca la directiva memory_limit y cámbiala a 512M o incluso 1G si tienes una tienda grande.
2. Activa el modo de depuración: Para ver el error real en lugar de la pantalla blanca, necesitas activar el modo de depuración de PrestaShop. Puedes hacerlo editando el archivo defines.inc.php que se encuentra en la raíz de tu instalación. Busca la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Guarda el archivo y recarga tu tienda. Ahora verás el error específico, lo que te ayudará a identificar el módulo o archivo problemático.
3. Desactiva el modo de depuración: Una vez que hayas anotado el error, vuelve a cambiar el valor a false. Dejar el modo de depuración activo en una tienda en producción es un riesgo de seguridad grave.

[INFO] Un error común de PHP es el "Allowed memory size of X bytes exhausted". Esto confirma el problema de memoria. Siguiendo el paso 1, lo solucionarás en la mayoría de los casos.

El Problema de la Caché: "PrestaShop caché limpiar" es la Solución Mágica

Muchos errores extraños, como productos que no se actualizan, CSS que no carga o precios incorrectos, se deben a una caché corrupta. Aprender a limpiar la caché de PrestaShop es una habilidad esencial.

Cómo Limpiar la Caché desde el Panel de Administración

1. Accede a tu back-office de PrestaShop (tudominio.com/admin...).
2. Ve al menú "Parámetros avanzados" en el panel lateral.
3. Haz clic en "Rendimiento".
4. En la parte superior, verás el botón "Vaciar la caché". Haz clic en él. Verás un mensaje de confirmación. Esto limpiará la caché de Smarty y la de PHP.

Cómo Limpiar la Caché desde Syspanel (Método Manual)

Si no puedes acceder al back-office, este es tu plan B.

1. Accede a Syspanel (puerto 2106).
2. Abre el Administrador de archivos.
3. Navega a la carpeta raíz de tu PrestaShop.
4. Busca la carpeta /var/cache. Como mencionamos antes, borra todo el contenido de las subcarpetas dev y prod, pero no borres las carpetas en sí.
5. Busca la carpeta /cache (en versiones antiguas de PrestaShop 1.6). Si existe, borra todos los archivos que estén dentro, pero no la carpeta.
6. Recarga tu tienda. El error debería desaparecer.

[TIP] Si tu tienda sigue mostrando problemas de caché, puedes desactivar la caché de PrestaShop desde el mismo menú "Rendimiento" en el back-office. Cambia "Caché" a "No" y guarda. Esto ralentizará un poco la tienda, pero te ayudará a identificar si la caché es el problema.

Errores de "Permiso Denegado" al Subir Archivos o Imágenes

Este error es muy común al intentar subir productos con imágenes desde el back-office.

Solución Paso a Paso para el Error de Permisos

1. Accede a Syspanel (puerto 2106).
2. Abre el Administrador de archivos.
3. Navega a la raíz de tu PrestaShop.
4. Selecciona todas las carpetas y archivos (puedes usar Ctrl+A).
5. Haz clic derecho y selecciona "Permisos".
6. Aplica los permisos correctos: Pon 755 para las carpetas y 644 para los archivos. Asegúrate de marcar la casilla de "Aplicar a subcarpetas" y "Aplicar a archivos" para que se haga de forma recursiva.
7. Espera a que termine el proceso. Esto puede tardar unos minutos si tienes muchos archivos.
8. Intenta subir la imagen de nuevo. El error debería haberse solucionado.

Preguntas Frecuentes (FAQ) sobre errores PrestaShop

Para terminar, vamos a responder a las preguntas más comunes que nos hacen nuestros clientes.

¿Por qué mi tienda PrestaShop se pone en mantenimiento sola?

Esto suele ocurrir por un error en el código o un conflicto de módulos. PrestaShop activa el modo mantenimiento automáticamente para evitar mostrar errores a los clientes. Para desactivarlo, ve a "Parámetros avanzados" -> "Mantenimiento" en tu back-office y cambia el estado a "Sí" (tienda activa). Si no puedes acceder, tendrás que desactivarlo desde la base de datos, pero es mejor que contactes con soporte.

¿Cómo sé qué versión de PHP necesita mi PrestaShop?

Puedes verlo en la sección "Parámetros avanzados" -> "Información" en tu back-office. PrestaShop te indicará si tu versión de PHP es la recomendada. Si no, desde Syspanel puedes cambiar la versión de PHP fácilmente en la configuración de tu dominio.

¿Cada cuánto tiempo debo limpiar la caché?

No hay una regla fija. Te recomendamos limpiarla cada vez que hagas cambios importantes en tu tienda (instalar módulos, cambiar el theme, modificar CSS, etc.). Como práctica general, una vez al mes es una buena costumbre para mantener la tienda ágil.

El error 500 solo me pasa en el back-office, ¿qué hago?

Esto suele indicar un problema con un módulo que has instalado recientemente. Desactiva todos los módulos y ve activándolos de uno en uno para encontrar el que causa el error. También puede ser un problema de permisos en la carpeta /admin.

¿Puedo arreglar estos errores yo mismo o necesito a un experto?

Con esta guía, podrás solucionar el 80% de los errores comunes. Sin embargo, si el problema persiste o no te sientes cómodo realizando estos pasos, siempre es recomendable contactar con el soporte técnico de tu hosting. Ellos tienen acceso a herramientas más avanzadas y podrán diagnosticar el problema de raíz sin arriesgar tu tienda.

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que Syspanel (a través del puerto 2106) es tu mejor aliado para gestionar estos problemas. Con paciencia y estos pasos, tu tienda PrestaShop volverá a funcionar a la perfección en muy poco tiempo.