Cómo solucionar errores 500 en PrestaShop desde cPanel

¡Hola! Soy tu técnico de soporte amigable. 😊

¿Tu tienda PrestaShop muestra la temida pantalla blanca o el mensaje "Error 500 Internal Server Error"? No te preocupes, es uno de los errores más comunes, pero también uno de los más fáciles de solucionar si sabes por dónde empezar.

En este artículo, te guiaré paso a paso para solucionar el error 500 en PrestaShop usando cPanel, la herramienta de gestión de hosting más popular. Verás que, en la mayoría de los casos, el problema se resuelve en minutos.

Vamos a ello.

¿Qué es un error 500 en PrestaShop?

El error 500 (Error Interno del Servidor) es un "comodín" que indica que algo salió mal en el servidor, pero sin dar detalles específicos. Puede deberse a:

• Un plugin o módulo corrupto.
• Un tema defectuoso.
• Problemas de permisos de archivos.
• Límites de memoria PHP excedidos.
• Un archivo .htaccess dañado.
• Una actualización fallida.

No te asustes: con cPanel tienes todas las herramientas para diagnosticar y reparar el problema.

Paso 1: Accede a cPanel y revisa los logs de errores

Antes de tocar nada, necesitas saber qué está causando el error. Los logs son tu mejor amigo.

¿Cómo acceder a los logs desde cPanel?

1. Inicia sesión en tu cPanel. (Normalmente es tudominio.com/cpanel o tudominio.com:2083).
2. Busca la sección "Métricas" o "Registros".
3. Haz clic en "Error Log" o "Registro de errores".
4. Verás una lista de errores recientes. Busca líneas que contengan PHP Fatal error o require_once.

[TIP]: Si ves errores como require_once(/path/to/file.php): failed to open stream, el problema está en un archivo específico. Anota la ruta.

Paso 2: Aumenta el límite de memoria PHP (causa más común)

El 80% de los errores 500 en PrestaShop se deben a que PHP se queda sin memoria. Especialmente si tienes muchos módulos activos o una tienda con muchos productos.

Desde cPanel:

1. Ve a la sección "Software" y haz clic en "Seleccionar versión de PHP" (o "MultiPHP Manager").
2. Una vez dentro, busca la opción "Opciones" o "Switch to PHP Options".
3. Localiza la variable memory_limit y cámbiala a 256M o incluso 512M.
4. Guarda los cambios. El servidor se reiniciará automáticamente.

[WARNING]: Si tu hosting no te permite cambiar estos valores, contacta a tu proveedor y solicita que aumenten el límite de memoria para tu cuenta.

Paso 3: Verifica los permisos de archivos y carpetas

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

Permisos correctos para PrestaShop:

• Carpetas (directorios): 755
• Archivos: 644
• Archivos de configuración (config/settings.inc.php): 444 o 644 (nunca 777)

Cómo corregirlos desde cPanel:

1. En cPanel, busca "Administrador de archivos" (File Manager).
2. Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html).
3. Selecciona todos los archivos y carpetas (Ctrl+A).
4. Haz clic derecho y elige "Cambiar permisos".
5. Marca:
   • Para carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupos y otros).
   • Para archivos: 644 (lectura y escritura para propietario; solo lectura para grupos y otros).
6. Aplica los cambios.

[INFO]: Si tienes muchos archivos, este proceso puede tardar unos segundos. No cierres la ventana hasta que termine.

Paso 4: Desactiva módulos problemáticos (sin acceso al panel)

Si el error 500 te impide entrar al back office de PrestaShop, puedes desactivar módulos manualmente.

Método rápido: renombrar la carpeta de módulos

1. En el Administrador de archivos de cPanel, ve a /public_html/modules/.
2. Dentro, busca carpetas de módulos que hayas instalado recientemente o que sean sospechosos (por ejemplo, uno de pago o envío).
3. Renombra la carpeta del módulo sospechoso añadiendo _old al final (ej: paypal_old).
4. Vuelve a cargar tu tienda. Si el error desaparece, ese módulo es el culpable.

[TIP]: Si no sabes cuál es el módulo problemático, renombra la carpeta modules entera a modules_old, crea una carpeta nueva vacía llamada modules y sube solo los módulos esenciales (por ejemplo, el de "ps_mainmenu" y "ps_currencyselector"). Luego ve reactivándolos uno a uno.

Paso 5: Revisa el archivo .htaccess

Un archivo .htaccess corrupto o mal configurado puede provocar un error 500.

Cómo regenerarlo desde cPanel:

1. En el Administrador de archivos, localiza el archivo .htaccess en la raíz de tu PrestaShop (normalmente en public_html).
2. Renómbralo a .htaccess_old (por si acaso).
3. Ve a tu back office de PrestaShop (si puedes acceder) → Configuración de la tienda → Tráfico y SEO → URLs amigables.
4. Activa y desactiva la opción "URLs amigables" y guarda. Esto regenerará el .htaccess.

[WARNING]: Si no puedes acceder al back office, descarga el archivo .htaccess_old a tu PC, ábrelo con un editor de texto (Bloc de notas) y busca líneas sospechosas como redirecciones extrañas. Luego súbelo de nuevo.

Paso 6: Limpia la caché de PrestaShop y de Smarty

La caché corrupta también puede causar errores 500.

Si puedes acceder al back office:

1. Ve a Parámetros avanzados → Rendimiento.
2. En "Caché", selecciona "No" y guarda.
3. En "Forzar compilación", selecciona "Sí".
4. Guarda de nuevo y luego vuelve a poner "No" en "Forzar compilación".

Si no puedes acceder al back office:

1. En el Administrador de archivos, ve a /public_html/var/cache/.
2. Elimina todos los archivos y carpetas dentro de cache/ (no la carpeta en sí).
3. También borra el contenido de /public_html/var/smarty/cache/ y /public_html/var/smarty/compile/.

[INFO]: No te preocupes, PrestaShop regenerará estos archivos automáticamente.

Paso 7: Verifica la integridad de los archivos de PrestaShop

Si todo lo anterior falla, puede que algún archivo central de PrestaShop esté dañado.

Cómo restaurar archivos desde cPanel:

1. Descarga una copia limpia de PrestaShop desde prestashop.com (misma versión que tienes instalada).
2. Descomprime el archivo en tu PC.
3. Sube solo las carpetas admin, classes, controllers, override, src y vendor a tu servidor (reemplazando las existentes) usando el Administrador de archivos o FTP.
4. No subas la carpeta install ni themes (a menos que tu tema sea el problema).

[TIP]: Si tienes dudas, contacta a tu soporte técnico (como yo) para que te guíe en este paso.

Preguntas frecuentes (FAQ)

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

Sí, los plugins de caché (como los de CloudFlare o módulos internos) a veces guardan versiones corruptas. Desactívalos temporalmente.

¿Qué hago si el error aparece solo en el back office?

Prueba a acceder al front office (la tienda pública). Si funciona, el problema está en un módulo del back office. Sigue el paso 4 para desactivarlos.

¿Y si uso Syspanel (HestiaCP) en lugar de cPanel?

Si tu panel es Syspanel (HestiaCP), el proceso es similar. Accede a través del puerto 2106 (ej: tudominio.com:2106). Busca la sección de "Logs" y "Administrador de archivos". Los pasos son los mismos.

¿Debo borrar la carpeta install?

Sí, siempre. La carpeta install debe eliminarse después de instalar PrestaShop. Si está presente, puede causar conflictos.

[WARNING]: Nunca borres la carpeta config o img. Podrías perder la configuración de tu tienda.

Conclusión

Solucionar el error 500 en PrestaShop desde cPanel es más sencillo de lo que parece. Siguiendo estos pasos (logs, memoria PHP, permisos, módulos, .htaccess y caché) resolverás el 99% de los casos.

Recuerda:

• Siempre haz una copia de seguridad antes de modificar archivos.
• Si no te sientes seguro, contacta a tu hosting o a un técnico especializado.
• Y si usas Syspanel (HestiaCP), recuerda que el puerto es el 2106.

Espero que este artículo te haya sido de ayuda. Si tienes más dudas, ¡no dudes en preguntar! Estoy aquí para ayudarte. 🚀