Solucionar error 500 en PrestaShop (cPanel y más)

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a desglosar, paso a paso, cómo solucionar el temido error 500 en PrestaShop. No te preocupes, es más común de lo que crees y, con esta guía, podrás resolverlo tú mismo en la mayoría de los casos.

¿Qué es el error 500 en PrestaShop?

El error 500, también conocido como PrestaShop error interno del servidor, es un mensaje genérico que indica que algo salió mal en el servidor, pero no especifica qué. Es como si tu tienda te dijera: "Ups, algo se rompió, pero no sé decirte exactamente qué". Las causas pueden ser varias: desde un archivo .htaccess corrupto, un módulo incompatible, hasta un límite de memoria excedido.

[INFO] No te alarmes. El error 500 PrestaShop no significa que hayas perdido tus datos. Con paciencia y siguiendo estos pasos, lo solucionarás.

¿Por qué aparece el error 500 en mi tienda?

Antes de ponernos manos a la obra, es útil entender las causas más frecuentes:

• Archivo .htaccess dañado: Es el archivo de configuración del servidor web. A veces se corrompe al instalar o desinstalar módulos.
• Módulo o tema incompatible: Una actualización o instalación reciente puede generar conflictos.
• Límite de memoria PHP excedido: Si tu tienda tiene muchos productos o usas módulos pesados, el servidor puede quedarse sin memoria.
• Permisos de archivos incorrectos: Los archivos de PrestaShop necesitan permisos específicos para funcionar.
• Script con error fatal: Algún código PHP dentro de un módulo o plantilla está mal escrito.

Paso 1: Lo primero, activar el modo debug de PrestaShop

El modo debug te mostrará el error real en lugar de la pantalla blanca o el mensaje genérico "Error 500". Es la herramienta más valiosa para solucionar error 500.

Accede a tu servidor vía cPanel, Syspanel (recuerda que el puerto de acceso es el 2106) o mediante FTP. Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.

Ábrelo con un editor de texto (como el bloc de notas o un editor FTP). Busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y vuelve a cargar tu tienda. Ahora verás un mensaje de error detallado, como "Fatal error: Allowed memory size of...". Anota ese mensaje, te dará pistas clave.

[WARNING] No dejes el modo debug activado en tu tienda en producción (pública), ya que puede mostrar información sensible. Una vez resuelto el error, vuelve a poner false.

Paso 2: Soluciones rápidas para el error 500 PrestaShop

Si el modo debug no te da una pista clara, o si no puedes acceder al archivo, prueba estas soluciones genéricas.

2.1 Regenerar el archivo .htaccess

El archivo .htaccess suele ser el culpable número uno. Para regenerarlo:

1. Conéctate a tu servidor (cPanel, Syspanel, FTP).
2. Ve a la carpeta raíz de PrestaShop (donde están carpetas como admin, config, img, etc.).
3. Busca el archivo .htaccess (puede estar oculto; activa "Mostrar archivos ocultos" en tu FTP).
4. Renómbralo a algo como .htaccess_old (esto lo desactiva).
5. Ahora entra a tu tienda. Si funciona, el problema era el .htaccess.
6. Para regenerarlo, ve al Back Office de PrestaShop > Parámetros de la tienda > Tráfico y SEO > URLs amigables y haz clic en Guardar (sin cambiar nada). Esto creará un .htaccess nuevo.

2.2 Aumentar el límite de memoria PHP

Si el mensaje del modo debug decía algo como "Allowed memory size of X bytes exhausted", necesitas aumentar la memoria.

• Desde cPanel: Busca "Select PHP Version" (o "MultiPHP Manager"), luego haz clic en "Switch to PHP Options" y aumenta el valor de memory_limit (por ejemplo, a 256M o 512M).
• Desde Syspanel: Ve a la configuración de PHP de tu plan de hosting y busca la opción de límite de memoria.
• Editando un archivo: Si no tienes acceso a estas opciones, crea un archivo llamado php.ini en la raíz de PrestaShop con este contenido:

memory_limit = 256M
max_execution_time = 120

2.3 Deshabilitar módulos y temas sospechosos

Si el error apareció tras instalar un módulo o cambiar de tema, es muy probable que sea el culpable.

1. Conéctate a tu servidor y ve a la carpeta /modules/.
2. Renombra la carpeta del módulo que instalaste recientemente. Por ejemplo, de micromodulo a micromodulo_old. Esto lo desactiva.
3. Si no sabes cuál es, renombra la carpeta del módulo más reciente o la que te parezca sospechosa.
4. Vuelve a cargar tu tienda. Si funciona, ya sabes qué módulo causaba el error 500 PrestaShop.

También puedes desactivar el tema actual: renombra la carpeta /themes/tunombredetema/ a /themes/tunombredetema_old/ y PrestaShop usará el tema por defecto (si existe).

2.4 Verificar permisos de archivos

Los permisos incorrectos pueden generar errores internos. Los valores recomendados son:

• Carpetas: 755
• Archivos: 644

Puedes cambiarlos desde tu FTP (clic derecho > "Permisos" o "CHMOD") o desde cPanel (File Manager > seleccionar archivos > "Change Permissions").

[TIP] Si tienes muchos archivos, usa la opción "Recursivo" para aplicar los cambios a todas las subcarpetas.

Paso 3: Soluciones avanzadas (si lo anterior no funciona)

Si después de todo sigues viendo el error, toca profundizar un poco más.

3.1 Revisar los logs del servidor

Los logs son el registro de todo lo que ocurre en el servidor. Allí suele aparecer el error real.

• En cPanel: Ve a "Metrics" > "Errors" o "Raw Access Logs". Busca la línea que coincida con la hora del error.
• En Syspanel: Accede a la sección de logs de tu plan (suele estar en "Logs" o "Estadísticas").
• Por FTP: Busca la carpeta /logs/ o /error_log/ en la raíz de tu hosting. El archivo error_log suele estar en la raíz de PrestaShop.

Busca palabras como "PHP Fatal error" o "PrestaShop error interno" y verás la línea de código que falla.

3.2 Aumentar el límite de ejecución (max_execution_time)

Si tu tienda se queda "cargando" y luego da error, puede ser por tiempo de ejecución insuficiente. En el mismo lugar donde aumentaste el memory_limit, busca max_execution_time y ponlo a 120 o 180 segundos.

3.3 Desactivar la caché de PrestaShop

Una caché corrupta puede provocar errores 500. Para desactivarla:

1. Conéctate a tu servidor y borra la carpeta /var/cache/ (o /cache/ en versiones antiguas).
2. Si no puedes borrarla, renómbrala (ej: cache_old) y crea una nueva carpeta vacía llamada cache (con permisos 755).
3. Desde el Back Office (si puedes acceder), ve a Parámetros avanzados > Rendimiento y desactiva la caché temporalmente.

3.4 Comprobar la versión de PHP

PrestaShop requiere una versión de PHP específica. Si tu hosting actualizó PHP, puede que tu versión de PrestaShop no sea compatible.

• Versiones recomendadas: Para PrestaShop 1.7, PHP 7.4 o 8.0 (según la versión exacta). Para PrestaShop 1.6, PHP 7.4 es seguro.
• Cómo cambiarlo: En cPanel, usa "Select PHP Version". En Syspanel, busca la opción de cambiar versión de PHP en el panel de configuración.

[WARNING] No subas a PHP 8.1 o 8.2 si tu PrestaShop es antiguo, podría romperse por completo.

Preguntas frecuentes (FAQ) sobre el error 500 PrestaShop

P: ¿El error 500 puede borrar mis productos o pedidos?
R: No. El error 500 es solo un error de visualización o de proceso. Tus datos (productos, clientes, pedidos) están seguros en la base de datos.

P: ¿Qué hago si no puedo acceder ni al Back Office?
R: Sigue los pasos 2.1 (regenerar .htaccess), 2.2 (aumentar memoria) y 2.3 (deshabilitar módulos) desde el servidor (FTP o cPanel). Si aún así no funciona, contacta a tu soporte de hosting.

P: ¿Es seguro activar el modo debug?
R: Sí, para diagnosticar. Pero nunca lo dejes activo en una tienda en producción, ya que expone información interna a los visitantes.

P: Mi hosting usa Syspanel, ¿cómo accedo a los archivos?
R: Accede a Syspanel (puerto 2106) y usa el administrador de archivos integrado o los datos de FTP que te proporcionaron. Los pasos son idénticos a cPanel.

P: ¿Puedo solucionar el error 500 sin perder mi configuración?
R: Sí. Todas las soluciones que te he dado son no destructivas. Lo peor que puede pasar es que desactives un módulo o tema, pero luego puedes volver a activarlo.

Resumen final: Tu checklist para solucionar el error 500 PrestaShop

1. Activa el modo debug para ver el error real.
2. Regenera el .htaccess (renómbralo y luego guarda desde el Back Office).
3. Aumenta el límite de memoria PHP (a 256M o más).
4. Deshabilita módulos y temas recién instalados (renombrando sus carpetas).
5. Verifica los permisos de archivos y carpetas (755/644).
6. Revisa los logs del servidor para encontrar la causa exacta.
7. Borra la caché de PrestaShop.
8. Comprueba la versión de PHP y ajústala si es necesario.

[TIP] Si después de todo esto el error persiste, contacta a tu proveedor de hosting. A veces el problema está en la configuración del servidor (como un límite de ejecución de scripts o un firewall bloqueando algo) y solo ellos pueden solucionarlo.

Espero que esta guía te haya sido de ayuda. Recuerda: el error 500 PrestaShop no es el fin del mundo. Con calma y siguiendo los pasos, tu tienda volverá a funcionar en poco tiempo. ¡Ánimo y mucho éxito con tu ecommerce!