Solucionar error 500 en PrestaShop con Syspanel | Tutorial fácil

¡Hola! Soy el soporte técnico de tu hosting. Entiendo lo frustrante que es ver un error 500 en tu tienda PrestaShop. Es ese mensaje genérico de "Error interno del servidor" que no te dice nada concreto. No te preocupes, es más común de lo que crees y, en la mayoría de los casos, tiene solución.

Esta guía está diseñada para que, paso a paso, puedas solucionar el error 500 en PrestaShop usando tu panel de control Syspanel (el acceso a tu servidor vía puerto 2106). No necesitas ser un experto técnico; solo sigue las instrucciones al pie de la letra.

¿Qué es un Error 500 en PrestaShop?

Un error 500 es una respuesta genérica del servidor que indica que algo salió mal internamente, pero no especifica qué. En PrestaShop, las causas más frecuentes son:

Problemas de memoria (límite PHP alcanzado): Tu tienda necesita más memoria de la que tiene asignada.
Módulos o temas incompatibles: Una actualización o instalación reciente puede estar causando un conflicto.
Archivos de configuración corruptos: El archivo .htaccess o settings.inc.php puede tener errores.
Permisos de archivos incorrectos: PrestaShop necesita ciertos permisos para leer y escribir archivos.
Versiones de PHP incompatibles: Tu PrestaShop puede no ser compatible con la versión de PHP que tienes activa.

El objetivo de esta guía es ayudarte a identificar y corregir estas causas desde Syspanel.

Requisitos Previos: Acceso a Syspanel

Antes de empezar, asegúrate de tener a mano tus credenciales de Syspanel. Recuerda que el acceso se realiza a través del puerto 2106.

Abre tu navegador web.
Escribe en la barra de direcciones: https://tudominio.com:2106 (reemplaza tudominio.com por tu dominio real).
Introduce tu usuario y contraseña de Syspanel.

[INFO] Si no recuerdas tu contraseña de Syspanel, contacta con tu proveedor de hosting. Ellos pueden restablecerla.

Paso 1: Activar el Modo Debug de PrestaShop (La Clave)

El error 500 es mudo. Para que te hable, necesitas activar el modo debug de PrestaShop. Esto mostrará el error real (por ejemplo, "Allowed memory size exhausted").

¿Cómo activarlo desde Syspanel?

Accede al Administrador de Archivos:
- En tu panel de Syspanel, busca la sección "Archivos" o "Administrador de Archivos". Normalmente tiene un icono de carpeta.
- Se abrirá una ventana con la estructura de directorios de tu web.
Localiza el archivo config/defines.inc.php:
- Navega hasta la carpeta raíz de tu PrestaShop (suele llamarse public_html o el nombre de tu dominio).
- Dentro, busca la carpeta config.
- Dentro de config, busca el archivo defines.inc.php.
Edita el archivo:
- Haz clic derecho sobre defines.inc.php y selecciona "Editar" o "Edit". Se abrirá un editor de texto.
Cambia la línea clave:
- Busca la línea que dice: define('_PS_MODE_DEV_', false);
- Cámbiala por: define('_PS_MODE_DEV_', true);
- Guarda los cambios (Ctrl+S o el botón de guardar) y cierra el editor.
Recarga tu tienda:
- Vuelve a cargar la página de tu tienda que daba el error 500. Ahora, en lugar del error genérico, verás un mensaje de error detallado (en inglés técnico).

[WARNING] El modo debug muestra información sensible. Una vez hayas solucionado el error, NO OLVIDES volver a poner _PS_MODE_DEV_ en false. Si no, tu tienda será vulnerable.

Paso 2: Identificar el Error (Según el Mensaje)

Ahora que el modo debug está activo, verás un mensaje como este:

"Fatal error: Allowed memory size of X bytes exhausted..."
- Problema: Límite de memoria PHP insuficiente.
- Solución: Aumentar el límite de memoria (Paso 3).
"Fatal error: Uncaught Error: Class 'X' not found..."
- Problema: Un módulo o tema está intentando usar una clase que no existe (normalmente por una actualización incompleta).
- Solución: Deshabilitar el módulo o tema conflictivo (Paso 4).
"Parse error: syntax error, unexpected..."
- Problema: Error de sintaxis en un archivo PHP (normalmente en un módulo o tema personalizado).
- Solución: Revisar el archivo indicado o restaurar una copia de seguridad.
"Warning: require_once(/ruta/al/archivo.php): failed to open stream..."
- Problema: Archivo faltante o permisos incorrectos.
- Solución: Verificar permisos de archivos (Paso 5) o restaurar el archivo faltante.

Paso 3: Aumentar el Límite de Memoria PHP (Solución más común)

Si el error es de memoria, este paso lo solucionará casi siempre.

Ve a la configuración de PHP en Syspanel:
- Busca la sección "Ajustes del Servidor" o "PHP". En Syspanel, a menudo está dentro de "Hosting" o "Avanzado".
- Busca una opción que diga "Configuración de PHP" o "PHP Settings".
Localiza el parámetro memory_limit:
- En la lista de parámetros PHP, busca memory_limit.
- Por defecto suele ser 128M o 256M.
- Cámbialo a 512M o incluso 1024M (1GB) si tu hosting lo permite. No te excedas, pero 512MB suele ser suficiente para la mayoría de tiendas.
Guarda los cambios:
- Busca el botón "Guardar" o "Aplicar". El servidor se reiniciará automáticamente.
Prueba tu tienda:
- Vuelve a cargar la página. Si el error era de memoria, debería desaparecer.

[TIP] Si no encuentras la opción memory_limit, busca "PHP-FPM Settings" o "PHP Options". También puedes crearlo manualmente en un archivo .user.ini en la raíz de tu web con el contenido: memory_limit = 512M.

Paso 4: Deshabilitar Módulos o Temas Problemáticos

Si el error no es de memoria, lo más probable es que sea un módulo o tema recién instalado o actualizado.

¿Cómo deshabilitar un módulo desde Syspanel?

Accede a la base de datos (PhpMyAdmin):
- En Syspanel, busca la sección "Bases de Datos" o "PhpMyAdmin". Haz clic para abrirla.
- Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_module (o prestashop_module):
- En la lista de tablas, busca la que se llame ps_module (el prefijo puede variar, a veces es prestashop_). Haz clic en "Examinar" (o "Browse").
Identifica el módulo conflictivo:
- Busca el nombre del módulo que instalaste o actualizaste justo antes de que apareciera el error. Si no lo sabes, puedes deshabilitar todos los módulos de terceros uno por uno.
- En la fila del módulo, busca la columna active (activo). Debería tener un 1 (activo).
Cambia el estado a inactivo:
- Haz clic en el icono de "Editar" (normalmente un lápiz) en la fila del módulo.
- Cambia el valor de la columna active de 1 a 0.
- Haz clic en "Continuar" o "Guardar".
Prueba tu tienda:
- Vuelve a cargar la página. Si el error desaparece, has encontrado el módulo problemático. Desinstálalo desde el back office de PrestaShop (si puedes acceder) o desde el administrador de archivos eliminando su carpeta en /modules/.

[WARNING] Si no puedes acceder a PhpMyAdmin, puedes deshabilitar módulos renombrando temporalmente la carpeta del módulo en /modules/ desde el Administrador de Archivos de Syspanel. Por ejemplo, cambia mimodulo a mimodulo_desactivado. Esto forzará a PrestaShop a ignorarlo.

¿Cómo cambiar el tema por defecto?

Si el problema es el tema, puedes forzar el tema por defecto de PrestaShop (por ejemplo, "classic") desde la base de datos:

En PhpMyAdmin, busca la tabla ps_configuration.
Busca las filas donde name sea PS_THEME_NAME.
Cambia su value a classic (o el nombre del tema por defecto de tu versión de PrestaShop).
Repite el paso para PS_THEME (si existe).

Paso 5: Verificar y Corregir Permisos de Archivos

Los permisos incorrectos pueden impedir que PrestaShop lea o escriba archivos, causando un error 500.

Accede al Administrador de Archivos de Syspanel.
Selecciona toda la carpeta de tu tienda (normalmente public_html).
Busca la opción "Permisos" o "Chmod":
- En la barra de herramientas del administrador de archivos, busca un icono que parezca un candado o un engranaje, o un menú desplegable que diga "Permisos".
Establece los permisos correctos:
- Carpetas: Deben tener permisos 755.
- Archivos: Deben tener permisos 644.
- Archivos especiales (como config/settings.inc.php): A veces necesitan 644 o incluso 444 (solo lectura) para mayor seguridad.
- Carpetas de caché (/cache/, /log/, /img/, /upload/): A veces necesitan 777 para que PrestaShop pueda escribir en ellas. Si tienes problemas, pruébalo.

[INFO] La mayoría de administradores de archivos permiten cambiar permisos de forma recursiva (aplicar a todas las subcarpetas y archivos). Marca esa opción para asegurarte de que todo queda correcto.

Paso 6: Regenerar el Archivo .htaccess

Un archivo .htaccess corrupto es otra causa común de error 500.

Accede al Administrador de Archivos de Syspanel.
Localiza el archivo .htaccess en la raíz de tu tienda (carpeta public_html).
- IMPORTANTE: Este archivo puede estar oculto. En el administrador de archivos, busca una opción para "Mostrar archivos ocultos" (normalmente un icono de ojo o una casilla de verificación).
Renómbralo a .htaccess_old (por si acaso).
Ve al back office de PrestaShop (si puedes acceder).
- Ve a "Configuración de la tienda" > "Tráfico y SEO" > "SEO y URLs".
- Haz clic en "Guardar" sin cambiar nada. Esto regenerará automáticamente el archivo .htaccess.
Prueba tu tienda.

[TIP] Si no puedes acceder al back office, puedes crear un archivo .htaccess básico desde el administrador de archivos. Crea un nuevo archivo de texto, pégalo y guárdalo como .htaccess. El contenido básico para PrestaShop es extenso, pero puedes pedirle a tu hosting que te proporcione uno genérico.

Paso 7: Restaurar una Copia de Seguridad (Último Recurso)

Si nada de lo anterior funciona, tu última opción es restaurar una copia de seguridad de tu tienda. Syspanel suele tener una herramienta de backups.

En Syspanel, busca "Copia de seguridad" o "Backup".
Selecciona una copia de seguridad anterior a la fecha en que comenzó el error 500.
Inicia la restauración. Ten en cuenta que esto sobrescribirá tu tienda actual.

[WARNING] Siempre haz una copia de seguridad de tu estado actual antes de restaurar una anterior, por si la restauración no soluciona el problema.

Preguntas Frecuentes (FAQ)

1. ¿Qué hago si el modo debug no muestra nada (pantalla en blanco)?

A veces el error es tan grave que ni el modo debug se muestra. Prueba a:

Aumentar el límite de memoria (Paso 3) desde Syspanel.
Deshabilitar todos los módulos renombrando la carpeta /modules/ a /modules_old/ desde el administrador de archivos. Si la tienda se carga, el problema es un módulo. Luego, ve moviendo módulos de vuelta uno por uno hasta encontrar el culpable.
Cambiar el tema forzando el tema por defecto desde la base de datos (Paso 4).

2. ¿Puedo aumentar la memoria a 2GB?

Depende de tu plan de hosting. Si tu plan es limitado, el servidor no lo permitirá. Lo normal es 512MB o 1GB. Si necesitas más, contacta con tu proveedor para mejorar el plan.

3. ¿El error 500 puede deberse a un plugin de caché?

Sí, los plugins de caché (como los de PrestaShop o de terceros) pueden generar conflictos. Si tienes uno instalado, intenta deshabilitarlo desde la base de datos (como en el Paso 4) o eliminando su carpeta de /modules/.

4. ¿Qué significa el error "500 Internal Server Error" en el log de errores de Syspanel?

En Syspanel, puedes ver los logs de errores del servidor (Apache/Nginx). Busca "Registros de errores" o "Error Logs". Allí verás mensajes más detallados que el modo debug de PrestaShop. Busca líneas que contengan "PHP Fatal error" o "mod_security".

5. ¿Debo contactar con el soporte técnico?

Si después de seguir todos estos pasos el error persiste, SÍ. Proporciona a tu soporte técnico:

El mensaje de error exacto (del modo debug o del log de errores).
Los pasos que ya has intentado.
La versión de PrestaShop y PHP que usas.

Resumen Final

Causa Común	Síntoma en Debug	Solución desde Syspanel
Límite de memoria	"Allowed memory size exhausted"	Aumentar `memory_limit` en PHP Settings.
Módulo/Tema roto	"Class not found" o "syntax error"	Deshabilitar módulo en PhpMyAdmin o renombrar carpeta.
Archivo corrupto	Archivo no encontrado o error de sintaxis	Regenerar `.htaccess` o restaurar backup.
Permisos incorrectos	Error de lectura/escritura	Cambiar permisos a 755 (carpetas) y 644 (archivos).

Espero que esta guía te haya sido de gran ayuda. Recuerda que Syspanel es tu aliado para gestionar tu hosting. Si tienes más dudas, no dudes en preguntar. ¡Buena suerte con tu tienda!