Error 500 en PrestaShop | Solución en hosting WordPress

¿Te ha aparecido el temido error 500 PrestaShop justo cuando estabas trabajando en tu tienda online? No te preocupes, es uno de los problemas más comunes en el mundo del eCommerce y, aunque parezca grave, en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo en pocos minutos.

En este artículo, vamos a desglosar paso a paso cómo solucionar error 500 en una tienda PrestaShop, incluso si tu tienda está alojada en un entorno que utiliza un panel de control como Syspanel (antes conocido como HestiaCP, recuerda que el acceso a este panel es siempre a través del puerto 2106).

Vamos a ir desde lo más básico y menos invasivo hasta lo más técnico, para que puedas ir probando soluciones en orden. Respira hondo, coge una taza de café y vamos a ello.

¿Qué significa exactamente el error 500?

Antes de ponernos manos a la obra, es fundamental entender qué está pasando. El error 500 es un código de estado HTTP que significa "Error Interno del Servidor". En otras palabras, el servidor donde está alojada tu web ha encontrado una condición inesperada que le impide completar la petición.

Es un error genérico, lo que significa que no te dice exactamente qué ha fallado. Puede ser desde un archivo con permisos incorrectos, un módulo que acaba de instalar y ha roto algo, hasta un problema de memoria o un error en el archivo de configuración.

Para que lo entiendas de forma simple: es como si el motor de tu coche fallara, pero el tablero solo te dijera "Fallo en el motor" sin especificar si es la bujía, el combustible o la batería. Tendremos que hacer un diagnóstico.

Paso 1: Lo primero, ¿tienes un backup reciente?

[WARNING] Antes de tocar absolutamente nada, verifica que tienes una copia de seguridad reciente de tu tienda (archivos y base de datos). Si algo sale mal durante el proceso de arreglo, podrás restaurar tu tienda en minutos. Si no tienes backup, detente y haz uno ahora. Es tu red de seguridad.

Paso 2: Activa el modo depuración para ver el error real

El error 500 es mudo, pero PrestaShop tiene un modo de depuración (Debug) que puede revelar el mensaje de error exacto. Para activarlo, tendrás que editar un archivo llamado defines.inc.php.

Para ello, necesitas acceder a tu hosting vía FTP o desde el administrador de archivos de tu panel de control (Syspanel, puerto 2106).

Ve a la carpeta config de tu instalación de PrestaShop.
Busca el archivo defines.inc.php.
Edítalo con un editor de texto plano (como el Bloc de notas o Sublime Text).
Busca la línea que dice define('_PS_MODE_DEV_', false);
Cambia false por true.
Guarda el archivo y súbelo de nuevo al servidor.

Ahora, recarga tu tienda. En lugar del error 500, deberías ver un mensaje de error detallado en pantalla, indicando el archivo y la línea exacta donde está el problema. Anota ese mensaje, es oro puro.

[TIP] Si no te atreves a editar archivos, puedes intentar activar el modo debug desde la base de datos, pero la edición del archivo es la vía más rápida y fiable.

Una vez tengas el error, vuelve a cambiar _PS_MODE_DEV_ a false para no dejar tu tienda expuesta.

Paso 3: Revisa los permisos de archivos y carpetas

La causa más común del PrestaShop error servidor suele ser una mala asignación de permisos. Si has subido archivos recientemente o has movido tu tienda de servidor, los permisos pueden haberse cambiado.

Los permisos estándar para PrestaShop son:

Carpetas (Directorios): 755
Archivos: 644
El archivo config/settings.inc.php: 444 (en versiones antiguas) o 644 (en versiones nuevas).

Si no sabes cómo cambiar permisos, desde Syspanel (puerto 2106) puedes usar el administrador de archivos integrado, o si usas un cliente FTP como FileZilla, es muy sencillo:

Conecta por FTP.
Selecciona todos los archivos y carpetas de tu tienda.
Haz clic derecho y elige "Atributos del archivo".
Marca los permisos 755 para carpetas y 644 para archivos.
Asegúrate de marcar la opción "Recursivo" para que se aplique a todas las subcarpetas.

[INFO] Si tu tienda usa un sistema de caché, a veces los permisos de la carpeta var/cache (en PrestaShop 1.7 y 1.8) o cache (en PrestaShop 1.6) deben ser 755 para que el sistema pueda escribir en ellos. Si el problema persiste, dale permisos 777 temporalmente a esa carpeta concreta, arregla el error y luego vuelve a poner 755.

Paso 4: Desactiva todos los módulos (o el que acabaste de instalar)

Si el error apareció justo después de instalar o actualizar un módulo, el culpable es casi seguro ese módulo.

El método más rápido es renombrar la carpeta del módulo para que PrestaShop no pueda cargarlo. Esto se hace por FTP o desde el administrador de archivos.

Ve a la carpeta modules.
Busca la carpeta del módulo que instalaste recientemente (o el que creas que causa el problema).
Cámbiale el nombre, por ejemplo, de mimodulo a mimodulo_old.
Recarga tu tienda. Si el error desaparece, has encontrado al culpable.

Si no tienes ni idea de qué módulo puede ser, tendrás que renombrar todos los módulos de uno en uno o en grupos para aislar el problema. Es un poco tedioso, pero funciona.

Paso 5: Aumenta el límite de memoria PHP

Otro culpable muy común es que el script esté agotando la memoria permitida por el servidor. PrestaShop es una plataforma que consume muchos recursos, especialmente en el panel de administración.

Para aumentar el límite de memoria, tienes que editar el archivo php.ini o el archivo .htaccess en la raíz de tu tienda.

Opción A: Editar el .htaccess

Localiza el archivo .htaccess en la raíz de tu PrestaShop.
Haz una copia de seguridad del archivo.
Añade estas líneas al final del archivo:

php_value memory_limit 256M
php_value max_execution_time 300

Opción B: Crear un php.ini

Si la opción anterior no funciona, crea un archivo llamado php.ini en la raíz de tu tienda y añade:

memory_limit = 256M
max_execution_time = 300

[TIP] Si estas opciones no funcionan, es posible que tu hosting tenga límites estrictos. Contacta con tu proveedor de hosting y pregúntales si pueden aumentar el límite de memoria para tu cuenta.

Paso 6: Revisa el archivo .htaccess

El archivo .htaccess puede corromperse fácilmente, especialmente si has estado trabajando con reglas de reescritura de URL (amigables). Un error en este archivo puede provocar un error 500 PrestaShop inmediato.

La solución más rápida es regenerarlo desde el panel de administración de PrestaShop.

Ve a tu panel de administración (si puedes acceder, claro).
Navega a Parámetros avanzados > Rendimiento (en PrestaShop 1.7) o Preferencias > SEO y URLs (en PrestaShop 1.6).
Busca la opción para Guardar o Regenerar el archivo .htaccess. Suele ser un botón que dice "Guardar" o "Actualizar".
Si no puedes acceder al panel, tendrás que restaurar el .htaccess desde tu backup o crear uno nuevo vacío. Si creas uno vacío, PrestaShop lo regenerará la próxima vez que guardes la configuración de SEO.

[WARNING] No borres el .htaccess si no sabes lo que estás haciendo, ya que puede contener reglas importantes de seguridad o redireccionamientos. Si lo haces, asegúrate de tener una copia de seguridad.

Paso 7: Revisa los logs del servidor

Si has llegado hasta aquí y el error persiste, es hora de mirar los registros del servidor. Estos logs te dirán exactamente qué está fallando.

Desde tu panel de Syspanel (puerto 2106):

Accede a la sección de "Registros" o "Logs".
Busca los logs de error de PHP o del servidor web (Apache o Nginx).
Abre el archivo de log más reciente y busca la última entrada relacionada con tu dominio o tienda.

El log te mostrará la línea exacta del archivo PHP que está causando el problema. Con esa información, podrás buscar en Google ese error específico o pedir ayuda en los foros de PrestaShop.

[INFO] Los logs de error son tu mejor amigo en estos casos. Aprender a leerlos te ahorrará muchísimo tiempo en el futuro.

Paso 8: Comprueba la base de datos

Un error en la base de datos también puede provocar un error 500.

Accede a phpMyAdmin desde Syspanel (puerto 2106).
Selecciona la base de datos de tu tienda.
Haz clic en la pestaña "Exportar" para hacer una copia de seguridad.
Luego, ve a la pestaña "Operaciones" y haz clic en "Optimizar tablas". Esto puede tardar unos minutos.
Si eso no funciona, intenta "Reparar tablas".

A veces, una tabla corrupta puede hacer que toda la tienda falle.

Paso 9: Verifica el espacio en disco

Parece increíble, pero que el servidor se quede sin espacio en disco es una causa común y silenciosa del error 500. Si el disco está lleno, el sistema no puede escribir archivos temporales y falla.

Desde Syspanel (puerto 2106), revisa el uso de disco de tu cuenta. Si está casi al 100%, elimina archivos temporales, backups antiguos o logs antiguos para liberar espacio.

Resumen y prevención futura

Para solucionar error 500 en PrestaShop, el orden lógico es:

Activar el modo debug para ver el error real.
Revisar permisos de archivos (755/644).
Desactivar módulos recientes.
Aumentar la memoria PHP.
Regenerar el .htaccess.
Consultar los logs del servidor.
Optimizar la base de datos.
Comprobar el espacio en disco.

[TIP] Para prevenir futuros sustos, te recomiendo:

Haz backups frecuentes: Automatiza las copias de seguridad.
Actualiza con cuidado: Antes de actualizar un módulo o el núcleo de PrestaShop, haz un backup y lee las notas de la versión.
No instales módulos piratas: Son la principal fuente de errores y vulnerabilidades.
Usa un buen hosting: Un hosting especializado en PrestaShop tendrá una configuración optimizada que reduce la posibilidad de errores.

Espero que esta guía te haya sido de ayuda. El PrestaShop error servidor es frustrante, pero con paciencia y siguiendo estos pasos, podrás recuperar tu tienda online en muy poco tiempo. ¡Mucho ánimo y a vender!