Cómo solucionar el error 500 en PrestaShop desde cPanel

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los errores más frustrantes que puedes encontrar en tu tienda PrestaShop: el temido Error 500 o Error Interno del Servidor. No te preocupes, es un problema muy común y, paso a paso, vamos a solucionarlo. Este artículo está pensado para que, incluso si no eres un experto técnico, puedas identificar la causa y aplicar la solución correcta. Vamos allá.

¿Qué es el Error 500 en PrestaShop?

El error 500, también conocido como error interno del servidor, es una respuesta genérica que indica que algo salió mal en el servidor web, pero no especifica qué. En PrestaShop, esto puede deberse a múltiples razones: desde un archivo de configuración dañado, un módulo incompatible, hasta un problema con los permisos de archivos o la memoria PHP. Lo importante es no alarmarse: con un enfoque metódico, lo solucionaremos.

¿Por qué ocurre en un entorno cPanel?

cPanel es uno de los paneles de control de hosting más populares. Aunque es muy potente, a veces la configuración predeterminada no es la ideal para PrestaShop. Errores comunes incluyen límites de memoria PHP bajos, archivos .htaccess corruptos o conflictos con módulos. También puede ocurrir al migrar una tienda o al actualizar la versión de PrestaShop.

Paso 1: Lo primero, habilita la visualización de errores

Por defecto, PrestaShop oculta los detalles del error 500. Para ver el error real, necesitamos modificar un archivo. Accede a tu cPanel y usa el Administrador de Archivos (File Manager). Busca la carpeta raíz de tu tienda (generalmente public_html o una subcarpeta). Localiza el archivo config/defines.inc.php. Ábrelo para editarlo.

Busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda el archivo. Ahora, al recargar tu tienda, en lugar del error 500, verás un mensaje de error más descriptivo (por ejemplo, "Class not found" o "Allowed memory size exhausted"). Importante: Una vez resuelto el problema, vuelve a poner false para ocultar los errores en producción.

[WARNING] No dejes el modo desarrollo activado en una tienda en producción, ya que expone información sensible.

Paso 2: Aumenta el límite de memoria PHP

Una causa muy frecuente del error 500 en PrestaShop es que el límite de memoria PHP es insuficiente. PrestaShop requiere al menos 128 MB, pero recomendamos 256 MB o más. Desde cPanel, busca la sección Seleccionar versión de PHP (o MultiPHP Manager) y haz clic en Opciones (o "Switch to PHP Options"). Busca la opción memory_limit y cámbiala a 256M o 512M. Guarda los cambios.

Si no encuentras esta opción, puedes crear o modificar un archivo php.ini en la raíz de tu tienda. Crea un archivo llamado php.ini con este contenido:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

Guárdalo y prueba de nuevo.

Paso 3: Verifica los permisos de archivos y carpetas

Los permisos incorrectos pueden provocar un error 500. En PrestaShop, las carpetas deben tener permisos 755 y los archivos 644. Desde el Administrador de Archivos de cPanel, selecciona toda la carpeta de tu tienda, haz clic derecho y elige Cambiar permisos. Marca las opciones:

Propietario: Lectura, Escritura, Ejecución (7)
Grupo: Lectura, Ejecución (5)
Público: Lectura, Ejecución (5)
Para archivos, el grupo y público solo deben tener Lectura (4). Aplica a todas las subcarpetas y archivos.

[TIP] Si usas un cliente FTP, puedes hacerlo desde allí con comandos como chmod -R 755 para carpetas y find . -type f -exec chmod 644 {} \; para archivos.

Paso 4: Revisa el archivo .htaccess

Un archivo .htaccess corrupto o mal configurado es otra causa común. PrestaShop genera automáticamente este archivo en la raíz. Puedes renombrarlo a .htaccess_backup (para tener una copia) y luego generar uno nuevo desde el back office de PrestaShop: ve a Configuración → Tráfico y SEO → URL amigables y desactiva y reactiva la opción "URLs amigables". Guarda los cambios. Si no puedes acceder al back office, crea un archivo .htaccess vacío y luego desde el back office regenéralo.

Paso 5: Desactiva módulos problemáticos

A veces un módulo recién instalado o actualizado causa el error 500. Para desactivar módulos sin acceso al back office, puedes renombrar la carpeta modules (por ejemplo, a modules_backup) desde el Administrador de Archivos. Esto desactivará todos los módulos. Si la tienda funciona, sabes que el problema es un módulo. Luego, ve renombrando módulos de uno en uno (o en grupos) hasta encontrar el culpable.

Paso 6: Verifica la versión de PHP y PrestaShop

PrestaShop requiere una versión específica de PHP. Por ejemplo, PrestaShop 1.7 funciona con PHP 7.1 a 7.4, pero no con PHP 8.0+ (a menos que esté actualizado). Desde cPanel, en Seleccionar versión de PHP, elige una compatible con tu versión de PrestaShop. Si no sabes cuál es tu versión, revisa el archivo VERSION en la raíz de tu tienda.

Paso 7: Revisa los logs del servidor

Si nada de lo anterior funciona, debemos consultar los logs de error del servidor. En cPanel, busca la sección Errores o Registros de errores (a veces llamado "Error Log"). Allí encontrarás mensajes detallados como "PHP Fatal error: Allowed memory size exhausted" o "require(): Failed opening required". Estos mensajes te darán la pista exacta.

[INFO] Si no encuentras los logs en cPanel, puedes pedirle a tu proveedor de hosting que te los facilite. También puedes revisar el archivo error_log en la raíz de tu tienda (si existe).

Paso 8: Reinstala los archivos del núcleo de PrestaShop

Si el error persiste, es posible que algún archivo del núcleo de PrestaShop esté dañado o incompleto. Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial. Descomprime el archivo y sube la carpeta admin, classes, controllers, src y vendor (reemplazando los archivos existentes) a través de FTP o el Administrador de Archivos. No subas la carpeta install ni el archivo config/settings.inc.php (si existe), ya que podrías perder tu configuración.

Paso 9: Verifica la base de datos

Un error en la base de datos también puede provocar un error 500. Desde cPanel, abre phpMyAdmin, selecciona la base de datos de tu tienda y haz clic en Verificar (o "Check table") para todas las tablas. Si encuentras tablas corruptas, repáralas con la opción Reparar. También puedes ejecutar la consulta SQL: REPAIR TABLE nombre_de_la_tabla;.

Paso 10: Contacta con tu proveedor de hosting

Si después de todos estos pasos el error 500 persiste, el problema puede estar en el servidor mismo (por ejemplo, límites de recursos del plan de hosting o configuraciones de seguridad). Contacta al soporte de tu hosting y diles que has seguido estos pasos. Ellos podrán revisar los logs del servidor a nivel de sistema.

Preguntas frecuentes (FAQ)

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

Sí, los plugins de caché mal configurados pueden generar conflictos. Prueba a desactivar la caché desde el back office (si puedes acceder) o renombrando la carpeta cache a cache_backup desde el Administrador de Archivos.

¿Qué hago si no puedo acceder al back office de PrestaShop?

Puedes realizar la mayoría de las acciones desde el Administrador de Archivos de cPanel o mediante FTP. Si necesitas modificar la base de datos, usa phpMyAdmin. Si todo falla, sigue los pasos para desactivar módulos o reinstalar el núcleo.

¿Es seguro modificar el archivo defines.inc.php?

Sí, es seguro siempre que recuerdes volver a poner _PS_MODE_DEV_ en false después de solucionar el error. Dejarlo en true expone información técnica a los visitantes.

¿Puedo evitar el error 500 en el futuro?

Sí, manteniendo PrestaShop y sus módulos actualizados, usando una versión de PHP compatible, y realizando copias de seguridad periódicas. También es recomendable no instalar módulos de fuentes no confiables.

Conclusión

El error 500 en PrestaShop puede parecer abrumador, pero como has visto, siguiendo estos pasos de forma ordenada puedes identificar y solucionar la causa. Recuerda siempre empezar por habilitar la visualización de errores, luego revisar la memoria PHP, los permisos y el .htaccess. Si todo falla, los logs del servidor son tu mejor aliado. Y si llegas al final sin éxito, no dudes en pedir ayuda a tu hosting: para eso estamos.

Espero que este artículo te haya sido de gran ayuda. Si tienes más dudas, recuerda que estamos aquí para apoyarte. ¡Buena suerte con tu tienda!