Solucionar error 500 en PrestaShop con Syspanel

¡Hola! Soy tu asistente técnico de confianza. Hoy vamos a desentrañar uno de los sustos más comunes al gestionar una tienda online: el temido error 500 en PrestaShop. Si estás viendo una pantalla en blanco o un mensaje de "Error interno del servidor", no entres en pánico. Este error es genérico, pero con los pasos adecuados (y usando Syspanel, nuestra herramienta de gestión) podemos solucionarlo. Como verás, la mayoría de las causas son fáciles de diagnosticar y reparar, incluso si no eres un experto técnico.

El error 500 PrestaShop puede aparecer por muchas razones: un módulo conflictivo, un archivo de configuración dañado, problemas de permisos, memoria insuficiente o incluso un fallo en la base de datos. Lo bueno es que, con la ayuda de Syspanel (accesible por el puerto 2106), podremos revisar logs, ajustar configuraciones y restaurar copias de seguridad sin necesidad de ser un desarrollador.

Vamos a dividir esta guía en varias etapas, desde lo más básico (reiniciar servicios) hasta lo más avanzado (editar archivos de configuración). Sigue cada paso con calma y, si algo no funciona, siempre puedes contactar con nuestro soporte.

¿Qué es el error 500 y por qué ocurre en PrestaShop?

El error 500 es un código de estado HTTP que indica que el servidor encontró un problema interno y no pudo completar la solicitud. En PrestaShop, esto suele deberse a:

Módulos o temas incompatibles: Una actualización reciente o un plugin mal codificado puede romper la tienda.
Archivos .htaccess corruptos: PrestaShop genera este archivo para las URLs amigables; si se daña, todo falla.
Límites de memoria PHP excedidos: Si tu tienda tiene muchos productos o módulos pesados, el script puede agotar la memoria.
Permisos incorrectos en archivos o carpetas: El servidor web necesita leer y escribir ciertos archivos.
Errores en la base de datos: Una tabla corrupta o una consulta mal formada.
Configuración de PHP inadecuada: Versión de PHP incorrecta o valores bajos en max_execution_time.

Con Syspanel podremos acceder a los logs del servidor (error_log) y a la configuración de PHP para identificar la causa exacta. No te preocupes, te guiaré paso a paso.

Paso 1: Acceder a Syspanel y revisar los logs del servidor

Lo primero es entrar a Syspanel. Recuerda que la dirección es https://tudominio.com:2106 (el puerto 2106 es exclusivo para Syspanel). Inicia sesión con tus credenciales de administrador.

### Localizar el error_log

Una vez dentro, busca la sección "Logs" o "Registros" (suele estar en el menú lateral).
Haz clic en "Error Log" o "Registro de errores del servidor".
Verás una lista de errores recientes. Busca líneas que contengan "PHP Fatal error", "require_once" o "Uncaught Error". Estos son los culpables típicos del error 500 PrestaShop.

[TIP] Si el log está vacío, puede que el error se deba a un problema de permisos. En ese caso, salta al Paso 3.

Por ejemplo, un error típico podría ser:

[25-Oct-2023 10:15:32 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function ps_clean() in /var/www/prestashop/modules/mimodulo/mimodulo.php:10

Esto indica que el módulo mimodulo está causando el fallo. Anota el nombre del módulo o archivo, porque lo necesitarás más adelante.

Paso 2: Desactivar módulos y temas desde Syspanel (sin acceso al panel de admin)

A veces el error 500 impide incluso entrar al back office de PrestaShop. No pasa nada, desde Syspanel podemos desactivar módulos manualmente.

### Desactivar todos los módulos no esenciales

En Syspanel, ve a "Archivos" o "Administrador de archivos".
Navega hasta la carpeta de tu tienda PrestaShop: /var/www/nombre-de-tu-tienda/.
Busca la carpeta modules. Dentro de ella, renombra las carpetas de los módulos sospechosos añadiendo un guion bajo al inicio (por ejemplo, _mimodulo). Esto los desactiva temporalmente.
Si no sabes cuál es el módulo problemático, renombra todos los módulos de terceros (deja solo los de PrestaShop, como ps_mainmenu o blockcart).
Después, intenta acceder a tu tienda. Si el error desaparece, ya sabes que el problema está en uno de esos módulos. Ve activándolos uno por uno para identificar al culpable.

### Cambiar temporalmente el tema

En Syspanel, ve a "Base de datos" > "phpMyAdmin" (o la herramienta de gestión de BD).
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_configuration (el prefijo puede variar).
Localiza la fila PS_THEME_NAME y cambia su valor a default (o a otro tema básico que tengas instalado).
Guarda los cambios y vuelve a cargar la tienda.

[WARNING] Si modificas la base de datos directamente, asegúrate de hacer una copia de seguridad antes. En Syspanel tienes la opción de "Backups" para crear una copia de seguridad completa.

Paso 3: Verificar y corregir permisos de archivos

Los permisos incorrectos son una causa muy común del Syspanel error 500. PrestaShop necesita que ciertos archivos y carpetas tengan permisos específicos.

### Permisos recomendados

Desde Syspanel, ve a "Archivos" y selecciona la raíz de tu tienda. Haz clic derecho y elige "Cambiar permisos". Ajusta:

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)

Si quieres hacerlo rápido, puedes ejecutar el siguiente comando en la terminal de Syspanel (sección "Comandos" o "Terminal"):

find /var/www/nombre-de-tu-tienda -type d -exec chmod 755 {} \;
find /var/www/nombre-de-tu-tienda -type f -exec chmod 644 {} \;

[INFO] Asegúrate de cambiar "nombre-de-tu-tienda" por la ruta real de tu instalación. Si no estás seguro, contacta con soporte.

Paso 4: Aumentar la memoria PHP y otros límites

Si el error 500 aparece al cargar páginas grandes (como catálogos con muchos productos), es probable que se deba a límites de PHP bajos.

### Desde Syspanel

Ve a "Configuración" > "PHP" (o "PHP Settings").
Busca las siguientes directivas y ajústalas a estos valores mínimos recomendados para PrestaShop 1.7+:
- memory_limit = 256M (o incluso 512M para tiendas grandes)
- max_execution_time = 300
- max_input_time = 300
- upload_max_filesize = 64M
- post_max_size = 64M
Guarda los cambios y reinicia el servicio PHP (en Syspanel suele haber un botón "Reiniciar PHP" o "Reiniciar servicios web").

[TIP] Si no ves estas opciones, puedes crear un archivo php.ini personalizado en la raíz de tu tienda. Desde el administrador de archivos, crea un archivo llamado php.ini con el siguiente contenido:
memory_limit = 256M
max_execution_time = 300

Paso 5: Reconstruir el archivo .htaccess

El archivo .htaccess de PrestaShop se regenera automáticamente, pero a veces se corrompe. Para forzar su recreación:

En Syspanel, ve a "Archivos" y localiza el archivo .htaccess en la raíz de tu tienda.
Renómbralo a .htaccess_old (por si acaso).
Ahora, accede al back office de PrestaShop (si puedes) y ve a "Configuración" > "Tráfico y SEO" > "URLs amigables". Desmarca y vuelve a marcar la opción "URLs amigables" y guarda. Esto regenerará el .htaccess.
Si no puedes entrar al back office, desde Syspanel puedes crear un archivo vacío con el nombre .htaccess y luego copiar el contenido estándar de PrestaShop (puedes obtenerlo de una instalación limpia o pedírselo a soporte).

[WARNING] No borres el .htaccess original sin antes hacer una copia de seguridad. Si algo sale mal, puedes restaurarlo.

Paso 6: Verificar la base de datos

Un error en la base de datos también puede provocar el error 500 PrestaShop. Desde Syspanel:

Ve a "Base de datos" > "phpMyAdmin".
Selecciona tu base de datos.
En la pestaña "Verificar" (o "Check"), selecciona todas las tablas y haz clic en "Reparar" (Repair) si encuentras alguna dañada.

También puedes ejecutar una consulta SQL para reparar todas las tablas:

REPAIR TABLE `ps_product`; -- Repite para cada tabla, o usa una herramienta de reparación masiva.

[INFO] Si no tienes experiencia con SQL, mejor pide ayuda a soporte. Un error en la base de datos puede empeorar las cosas.

Paso 7: Revisar la versión de PHP y los requisitos de PrestaShop

PrestaShop 1.7 requiere PHP 7.1 o superior (idealmente 7.4 u 8.0). Si tu servidor usa una versión antigua, pueden aparecer errores.

### Desde Syspanel

Ve a "Configuración" > "PHP".
Verifica la versión actual. Si es inferior a 7.1, cámbiala a una compatible (por ejemplo, 7.4).
Guarda y reinicia el servicio.

Si después de cambiar la versión el error persiste, puede que algún módulo no sea compatible con PHP 8. En ese caso, vuelve a PHP 7.4 y actualiza los módulos.

Paso 8: Activar el modo depuración de PrestaShop

A veces, el error 500 no muestra ningún detalle. Activar el modo depuración de PrestaShop puede revelar el mensaje exacto.

### Desde Syspanel (archivo config/defines.inc.php)

En Syspanel, ve a "Archivos" y navega a config/defines.inc.php.

Edita el archivo y busca la línea:

define('_PS_MODE_DEV_', false);

Cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda el archivo. Ahora, al cargar tu tienda, verás los errores PHP detallados en pantalla.
Una vez solucionado el problema, vuelve a poner false para evitar exponer información sensible.

[WARNING] No dejes el modo depuración activado en producción. Solo úsalo temporalmente para diagnosticar.

Paso 9: Restaurar una copia de seguridad desde Syspanel

Si después de todos los pasos anteriores el error persiste, la solución más rápida es restaurar una copia de seguridad de tu tienda desde un momento en que funcionaba correctamente.

### Pasos para restaurar

En Syspanel, ve a "Backups".
Selecciona la copia de seguridad más reciente (o una anterior a la aparición del error).
Haz clic en "Restaurar". Esto reemplazará tanto los archivos como la base de datos.
Espera a que termine el proceso (puede tardar varios minutos).
Una vez restaurado, verifica que la tienda funcione.

[TIP] Si no tienes copias de seguridad, este es un buen momento para configurar backups automáticos en Syspanel. Ve a "Programar tareas" y activa las copias diarias.

Preguntas frecuentes (FAQ)

¿El error 500 puede deberse a un ataque de seguridad?

Sí, aunque no es lo más común. Si sospechas de un ataque, revisa los logs de acceso en Syspanel (sección "Logs de acceso") para ver si hay direcciones IP sospechosas. También puedes escanear tu tienda con herramientas de seguridad.

¿Qué hago si no puedo acceder ni a Syspanel?

Si el error es tan grave que no puedes entrar a Syspanel, contacta con tu proveedor de hosting. Ellos pueden reiniciar servicios desde el panel principal o revisar los logs del servidor.

¿Puedo evitar futuros errores 500?

Sí, siguiendo estas buenas prácticas:

Mantén PrestaShop, módulos y temas actualizados.
Realiza copias de seguridad semanales.
Prueba las actualizaciones en un entorno de desarrollo antes de aplicarlas en producción.
No instales módulos de fuentes no confiables.

¿El error 500 afecta al SEO?

Sí, porque los motores de búsqueda no pueden acceder a tu tienda. Si el error se prolonga, puedes perder posiciones. Por eso es importante solucionarlo rápidamente.

Conclusión

El error 500 PrestaShop puede ser frustrante, pero como has visto, con Syspanel (puerto 2106) tienes todas las herramientas para diagnosticarlo y resolverlo: desde revisar logs, modificar permisos, ajustar PHP, hasta restaurar copias de seguridad. Recuerda siempre empezar por lo más simple (reiniciar servicios) y luego ir avanzando paso a paso.

Si después de seguir todos estos pasos el error persiste, no dudes en contactar con nuestro equipo de soporte técnico. Estamos aquí para ayudarte a que tu tienda vuelva a funcionar en minutos. ¡Ánimo, que esto se soluciona!