Solucionar error 500 en PrestaShop | Guía para SysAdmin

Imagina que estás trabajando tranquilamente en tu tienda PrestaShop, y de repente, ¡pum! Aparece la temida pantalla en blanco o el mensaje "Error 500 – Internal Server Error". No te preocupes, es el problema más común entre los administradores de sistemas y, con la guía adecuada, podrás solucionarlo como un verdadero SysAdmin PrestaShop.

Este artículo está diseñado para ser tu mapa de ruta. Vamos a desglosar, paso a paso, cómo diagnosticar y reparar un error 500 PrestaShop desde la perspectiva de un administrador de sistemas en un entorno Linux. No necesitas ser un genio de la programación, solo tener paciencia y seguir estas instrucciones al pie de la letra.

¿Qué es exactamente un Error 500 y por qué ocurre?

Un error 500 es un código de estado HTTP genérico que significa "Error interno del servidor". En términos simples, el servidor web (Apache o Nginx) no sabe cómo manejar lo que está pasando dentro de tu tienda. Las causas más frecuentes en PrestaShop son:

Archivos con permisos incorrectos: PrestaShop es muy sensible a los permisos de archivos y carpetas.
Problemas de memoria PHP: El script se queda sin memoria para ejecutarse.
Módulos o temas conflictivos: Un complemento recién instalado o un tema mal codificado.
Archivos .htaccess corruptos: Una regla mal escrita puede romper todo.
Problemas con la versión de PHP: Una versión incompatible o faltante de extensiones.
Errores en el archivo de configuración (settings.inc.php): Datos incorrectos de la base de datos.

Diagnóstico Inicial: El Primer Paso para Solucionar el Error

Antes de lanzarte a modificar archivos, necesitas saber qué está pasando realmente. El error 500 es mudo por naturaleza; no te dice nada. Por eso, lo primero es hacer que tu servidor hable.

Habilitar la visualización de errores PHP

Esta es la técnica más poderosa para un Linux troubleshooting efectivo. Al activar la visualización de errores, en lugar de una pantalla en blanco, verás un mensaje como: Fatal error: Allowed memory size of 134217728 bytes exhausted... Eso ya te da una pista.

Accede a tu servidor por SSH o al administrador de archivos de tu panel de control (como Syspanel en el puerto 2106).
Localiza el archivo config/defines.inc.php en la raíz de tu PrestaShop.
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo. Ahora, al recargar tu tienda, verás el error específico.

[WARNING] No dejes el modo desarrollo activado en producción. Una vez resuelto el problema, vuelve a poner false. Dejarlo activado expone información sensible de tu servidor.

Revisar los logs del servidor

Si el modo desarrollo no te da suficiente información, los logs son tu mejor amigo.

Logs de Apache/Nginx: Suelen estar en /var/log/apache2/error.log o /var/log/nginx/error.log. Puedes ver las últimas líneas con el comando: tail -f /var/log/apache2/error.log
Logs de PHP: Busca el archivo php_error.log o revisa la configuración de PHP (php.ini) para saber dónde se guardan.
Logs de PrestaShop: Dentro de la carpeta var/logs/ (en PrestaShop 1.7+) o log/ (en versiones anteriores).

Soluciones Prácticas para el Error 500 PrestaShop

Una vez que tienes una idea de la causa (o incluso si no), aquí tienes las soluciones más efectivas, ordenadas de la más sencilla a la más compleja.

1. Aumentar el Límite de Memoria PHP

Este es el culpable número uno. Si ves un error de memoria, o simplemente quieres descartarlo:

Accede a tu panel de control (por ejemplo, Syspanel en el puerto 2106) o edita el archivo php.ini por SSH.
Busca la directiva memory_limit.
Cámbiala a un valor más alto, por ejemplo: memory_limit = 256M o incluso 512M.
Guarda y reinicia el servicio PHP (php-fpm) o el servidor web.

Si no tienes acceso al php.ini, puedes intentar añadir esta línea al archivo .htaccess en la raíz de PrestaShop:

php_value memory_limit 256M

2. Restaurar los Permisos Correctos de Archivos y Carpetas

PrestaShop necesita permisos específicos para funcionar. Un error común es que los archivos tengan permisos 777 (demasiado abiertos) o 644 (correctos para archivos) pero mal asignados a carpetas.

Ejecuta estos comandos desde la raíz de tu tienda PrestaShop (reemplaza /ruta/a/tu/tienda):

find /ruta/a/tu/tienda -type f -exec chmod 644 {} \;
find /ruta/a/tu/tienda -type d -exec chmod 755 {} \;
chmod 777 -R /ruta/a/tu/tienda/var/cache
chmod 777 -R /ruta/a/tu/tienda/var/logs
chmod 777 -R /ruta/a/tu/tienda/img
chmod 777 -R /ruta/a/tu/tienda/config

[INFO] El usuario del servidor web (www-data, nginx, etc.) debe ser el propietario de los archivos. Si no, puedes cambiarlo con: chown -R www-data:www-data /ruta/a/tu/tienda

3. Deshabilitar Módulos y Temas desde la Base de Datos

A veces, un módulo o tema defectuoso rompe todo el sistema. Como no puedes acceder al panel de administración, lo harás directamente en la base de datos.

Accede a tu base de datos MySQL/MariaDB (por ejemplo, con phpMyAdmin o desde la terminal).
Busca la tabla ps_module (el prefijo ps_ puede variar).
Identifica el módulo problemático (el último que instalaste o actualizaste).
Cambia su estado a 0 (desactivado) con una consulta SQL como: UPDATE ps_module SET active = 0 WHERE id_module = X; (reemplaza X por el ID del módulo).
Para desactivar un tema, busca la tabla ps_theme y desactívalo.

4. Regenerar o Eliminar el Archivo .htaccess

Un .htaccess corrupto es otra causa frecuente. Lo más seguro es eliminarlo y dejar que PrestaShop lo regenere.

Conéctate por FTP o al administrador de archivos.
Renombra el archivo .htaccess en la raíz a .htaccess_old.
Recarga tu tienda. Si funciona, el problema estaba ahí.
Para regenerarlo, ve al panel de administración (si puedes acceder) a: Parámetros de la tienda > Tráfico y SEO > URL y haz clic en "Guardar" (sin cambiar nada). Si no puedes acceder, puedes crear un archivo .htaccess básico desde tu panel de hosting o usando un generador online.

5. Verificar la Versión de PHP y las Extensiones

PrestaShop 1.7 requiere PHP 7.1 o superior, idealmente 7.4 u 8.0. PrestaShop 8 necesita PHP 8.0+. Además, necesita extensiones como mysqli, pdo_mysql, gd, curl, openssl, json, xml, mbstring, etc.

Desde tu panel de control (como Syspanel en el puerto 2106), busca la opción "Seleccionar versión de PHP".
Asegúrate de tener una versión compatible y todas las extensiones necesarias activadas.
Si no estás seguro, crea un archivo info.php en la raíz con el contenido <?php phpinfo(); ?> y accede a él desde el navegador. Busca la sección "Loaded Configuration File" y las extensiones.

FAQ: Preguntas Frecuentes sobre el Error 500 en PrestaShop

¿Por qué veo el error 500 solo en algunas páginas y no en toda la tienda?

Esto suele indicar un problema localizado. Puede ser un módulo que solo se carga en esa página, un conflicto de JavaScript o un error en la plantilla de esa sección. Prueba a desactivar módulos uno por uno o a cambiar temporalmente al tema por defecto.

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

Sí, aunque no es lo más común. Un archivo malicioso inyectado en tu servidor puede causar un error 500. Revisa los logs de acceso (access.log) en busca de peticiones extrañas y ejecuta un escaneo de malware. Mantén PrestaShop y todos sus módulos siempre actualizados.

¿Cómo puedo prevenir futuros errores 500?

La prevención es clave. Sigue estas buenas prácticas:

Siempre haz una copia de seguridad antes de cualquier actualización o instalación de módulos.
Usa un entorno de pruebas (staging) para probar cambios antes de aplicarlos en producción.
Mantén actualizados PHP, el servidor web, el sistema operativo, PrestaShop y sus módulos.
Revisa los logs periódicamente para detectar problemas antes de que se conviertan en errores 500.

¿Qué hago si después de todo esto el error persiste?

Si has seguido todos los pasos y el error continúa, es momento de pedir ayuda profesional. Contacta con tu proveedor de hosting (si usas Syspanel, revisa la documentación o abre un ticket de soporte) o con un desarrollador especializado en PrestaShop. Proporciona toda la información que has recopilado: los logs de error, lo que has intentado y la versión de tu tienda.

Conclusión: Tú Puedes con el Error 500

Como has visto, solucionar error PrestaShop no es magia negra. Es cuestión de método y paciencia. Empieza siempre por habilitar la visualización de errores, revisa los logs y aplica las soluciones una por una.

Recuerda que la clave del SysAdmin PrestaShop es la calma y la sistematicidad. Cada error es una oportunidad para aprender más sobre cómo funciona tu tienda. Con esta PrestaShop guía, ya tienes las herramientas para enfrentarte al temido error 500 y salir victorioso. ¡Manos a la obra!