Solución a los errores más comunes de PrestaShop en cPanel y otros

Introducción: Por qué PrestaShop da errores en el hosting

Si tienes una tienda online con PrestaShop, es muy probable que en algún momento te hayas topado con pantallas en blanco, mensajes de error 500 o problemas extraños al cargar el panel de administración. No estás solo: estos fallos son de los más buscados en foros y soporte técnico, y la buena noticia es que casi todos tienen solución sin necesidad de ser un experto en programación.

En esta guía extensa y práctica, vamos a desglosar los errores PrestaShop solución más comunes, centrándonos especialmente en dos de los más temidos: el PrestaShop error 500 y la temida PrestaShop página en blanco. Te explicaré paso a paso, con un lenguaje claro y ejemplos, cómo diagnosticarlos y arreglarlos en tu hosting, ya sea compartido, VPS o dedicado.

¿Qué causa la mayoría de los errores en PrestaShop?

Antes de lanzarnos a las soluciones, es importante entender el origen. La mayoría de los errores de PrestaShop se deben a una de estas cuatro causas:

Permisos de archivos incorrectos (los famosos 644 y 755).
Problemas con el archivo .htaccess (corrupto, mal configurado o con reglas incompatibles).
Exceso de memoria PHP (límite de memoria demasiado bajo para el tamaño de tu tienda).
Errores de PHP (versión incompatible, módulos con código antiguo o funciones obsoletas).

Vamos a atacar cada uno de estos frentes, pero primero necesitamos saber qué error concreto tienes. Para ello, es fundamental activar el modo de depuración de PrestaShop, que nos mostrará el mensaje exacto en lugar de una pantalla genérica.

Activar el modo depuración (debug) para ver el error real

Tanto para el PrestaShop error 500 como para la PrestaShop página en blanco, el primer paso es siempre el mismo: ver el error real. PrestaShop oculta los detalles por seguridad, pero podemos hacer que los muestre.

Método rápido (editar el archivo config/defines.inc.php):

Accede a tu hosting mediante FTP o el Administrador de Archivos de tu panel (cPanel, Plesk, Syspanel, etc.).
Navega hasta la carpeta raíz de tu PrestaShop (donde están las carpetas admin, config, src, etc.).
Busca el archivo config/defines.inc.php.
Ábrelo con un editor de texto (como el Bloc de notas o el editor del propio panel).
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo y súbelo de nuevo (si usas FTP).

Método alternativo (desde el panel de administración):

Ve a tu panel de administración de PrestaShop (normalmente en tudominio.com/admin1234).
En el menú izquierdo, busca Parámetros avanzados > Rendimiento.
En la sección Depuración, cambia el interruptor a Sí.
Guarda los cambios.

[WARNING] Recuerda desactivar el modo debug cuando termines de arreglar el error. Dejarlo activo en producción muestra información sensible y ralentiza la tienda.

Ahora, cuando recargues la página con el error, verás un mensaje detallado con la línea exacta del archivo que falla. Anota ese mensaje, nos será muy útil.

Cómo arreglar el PrestaShop error 500 (Internal Server Error)

El PrestaShop error 500 es el más genérico y frustrante. Indica que el servidor encontró un problema interno, pero no te dice cuál. Aquí tienes las soluciones por orden de probabilidad.

1. Revisar y regenerar el archivo .htaccess

El .htaccess es un archivo de configuración que controla las redirecciones y el SEO. Si se corrompe o tiene reglas incompatibles, es la causa número uno del error 500.

Solución paso a paso:

Conecta por FTP a tu hosting.
Busca el archivo .htaccess en la raíz de PrestaShop. Ojo: si no lo ves, activa la opción "Mostrar archivos ocultos" en tu cliente FTP.
Descarga una copia de seguridad de este archivo a tu ordenador (por si acaso).
Ahora, elimina el archivo .htaccess del servidor.
Ve a tu panel de administración de PrestaShop. Si puedes acceder, ve a Parámetros avanzados > Rendimiento y pulsa el botón Regenerar el archivo .htaccess (suele estar en la parte superior).
Si no puedes acceder al panel, no te preocupes. Simplemente crea un archivo vacío llamado .htaccess y súbelo a la raíz. Luego, intenta cargar tu tienda. PrestaShop debería regenerarlo automáticamente al cargar cualquier página.

[TIP] Si el error persiste, prueba a renombrar el .htaccess a .htaccess_old en lugar de eliminarlo. Así podrás restaurarlo si algo sale mal.

2. Verificar los permisos de archivos y carpetas

Los permisos incorrectos son otra causa muy común. PrestaShop necesita permisos específicos para leer y escribir archivos.

Archivos: deben tener permiso 644.
Carpetas: deben tener permiso 755.
Carpetas especiales como config, cache y var a veces necesitan 777 temporalmente.

Cómo arreglarlo:

En tu cliente FTP, selecciona todos los archivos y carpetas de la raíz de PrestaShop.
Haz clic derecho y elige Permisos de archivos o Chmod.
Para archivos, introduce 644. Para carpetas, 755.
Aplica los cambios.

[WARNING] No dejes permisos 777 de forma permanente. Es un riesgo de seguridad grave. Úsalos solo para probar y luego vuelve a 755.

3. Aumentar el límite de memoria PHP

A veces, PrestaShop se queda sin memoria al procesar una página, lo que provoca el error 500.

Solución:

Accede a la carpeta raíz de PrestaShop.
Busca el archivo config/config.inc.php.
Ábrelo y añade esta línea al principio (después del <?php):

ini_set('memory_limit', '512M');

Guarda y sube el archivo.

También puedes intentar crear un archivo php.ini en la raíz con este contenido:

memory_limit = 512M
max_execution_time = 300

4. Revisar la versión de PHP

PrestaShop es exigente con las versiones de PHP. Si tu hosting actualizó PHP a una versión demasiado reciente (como PHP 8.3) y tu PrestaShop es antiguo (1.6 o 1.7 inicial), es muy probable que tengas errores.

Cómo solucionarlo:

Ve al panel de control de tu hosting (cPanel, Plesk, Syspanel, etc.).
Busca la sección Select PHP Version o MultiPHP Manager.
Prueba con una versión más estable para PrestaShop: PHP 7.4 o PHP 8.1 suelen ser las más compatibles.
Guarda y prueba de nuevo.

[INFO] Si usas Syspanel, el acceso a la configuración de PHP suele estar en la sección "Sitios web" > "PHP". Recuerda que el puerto de acceso a Syspanel es el 2106.

Cómo arreglar la PrestaShop página en blanco (White Screen of Death)

La PrestaShop página en blanco es igual de frustrante, pero suele tener causas más concretas. A diferencia del error 500, no hay mensaje de error, solo un vacío blanco. Aquí tienes las soluciones más efectivas.

1. Desactivar la caché de PrestaShop

La caché corrupta es la principal sospechosa de la página en blanco.

Solución:

Conecta por FTP a tu hosting.
Navega a la carpeta var/cache (en PrestaShop 1.7 y versiones posteriores) o cache (en PrestaShop 1.6).
Elimina todo el contenido de esa carpeta, pero no la carpeta en sí. Verás subcarpetas como dev, prod o class_index.php. Bórralas todas.
Recarga tu tienda. Debería volver a la vida.

[TIP] Si no puedes eliminar los archivos, prueba a cambiar los permisos de la carpeta cache a 777 temporalmente, elimina el contenido y vuelve a ponerla a 755.

2. Desactivar módulos problemáticos

Un módulo mal codificado o incompatible puede romper toda la tienda, dejándote con una página en blanco.

Cómo identificar y arreglar:

Si tienes acceso al panel de administración, ve a Módulos > Módulos y servicios.
Ordena los módulos por "Últimamente actualizados" o piensa cuál instalaste o actualizaste justo antes del error.
Desactiva los módulos sospechosos uno a uno y prueba la tienda.

Si no puedes acceder al panel:

Conecta por FTP.
Navega a la carpeta modules.
Renombra la carpeta del módulo sospechoso añadiendo _bak al final. Por ejemplo, paypal pasa a ser paypal_bak.
Prueba la tienda. Si se arregla, ese era el problema. Puedes eliminarlo o contactar con su desarrollador.

3. Limpiar las variables de Smarty (templates)

Smarty es el motor de plantillas de PrestaShop. A veces, las plantillas compiladas se corrompen.

Solución:

Ve a la carpeta var/cache (o cache).
Dentro, busca la carpeta smarty o tpl.
Elimina todo su contenido.
Recarga la tienda.

4. Revisar el archivo settings.inc.php (PrestaShop 1.6)

Si usas PrestaShop 1.6, el archivo config/settings.inc.php contiene la configuración de la base de datos. Si se corrompe, la página en blanco es inevitable.

Cómo arreglarlo:

Descarga una copia de seguridad de tu base de datos (desde phpMyAdmin o el panel de tu hosting).
Abre el archivo config/settings.inc.php.
Verifica que los datos de conexión a la base de datos son correctos (host, usuario, contraseña, nombre de BD).
Si algo no coincide, corrígelo y guarda.

Errores comunes adicionales y su solución rápida

Aunque nos centramos en el 500 y la página en blanco, hay otros errores frecuentes que conviene conocer.

Error de conexión a la base de datos

Síntoma: "Error de conexión a la base de datos" o "Link to database cannot be established".

Solución:

Verifica que el servidor de la base de datos está activo (desde el panel de hosting).
Comprueba las credenciales en config/settings.inc.php (1.6) o app/config/parameters.php (1.7+).
Si cambiaste de hosting, asegúrate de haber importado la base de datos correctamente.

Error 403 Forbidden

Síntoma: No tienes permiso para acceder a la página.

Solución:

Revisa los permisos de la carpeta admin (deben ser 755).
Verifica que el archivo .htaccess no tiene reglas de bloqueo de IP.
Comprueba que la carpeta admin no ha sido renombrada sin actualizar la referencia en la base de datos.

Error de instalación de módulos

Síntoma: "No se puede instalar el módulo" o "Error al descargar".

Solución:

Verifica que la carpeta modules tiene permisos de escritura (755).
Comprueba que el módulo es compatible con tu versión de PrestaShop.
Aumenta el límite de memoria PHP (como vimos antes).

Preguntas frecuentes (FAQ) sobre errores de PrestaShop

¿Por qué mi PrestaShop da error 500 después de mover el hosting?

Es muy común. Al mover el hosting, los permisos de archivos y el .htaccess suelen cambiar. Repite los pasos 1 y 2 de la sección del error 500.

¿Cómo sé si mi hosting es compatible con PrestaShop?

PrestaShop requiere al menos PHP 7.4, MySQL 5.6 y un servidor Apache o Nginx. Consulta los requisitos en la documentación oficial.

¿Puedo arreglar estos errores sin acceso FTP?

Es complicado, pero no imposible. Si solo tienes acceso al panel de administración, intenta la opción de regenerar el .htaccess y desactivar la caché desde ahí. Si no, contacta con tu proveedor de hosting para que te ayuden.

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

Si has probado todas las soluciones y sigues con el problema, te recomiendo:

Revisar los logs de error del servidor (en cPanel, Syspanel o Plesk suele haber una sección "Logs" o "Registros").
Contactar con el soporte de tu hosting. Ellos pueden ver los logs en tiempo real y decirte exactamente qué está fallando.
Si tienes una copia de seguridad reciente, restaura la tienda a ese estado.

[INFO] Recuerda que Syspanel es el panel de control que usamos en nuestros servidores. Puedes acceder a él a través del puerto 2106 (por ejemplo, tudominio.com:2106). Ahí encontrarás los logs, el gestor de archivos y las herramientas de base de datos.

Consejos finales para evitar futuros errores

Mantén todo actualizado: PrestaShop, módulos y plantillas. Las actualizaciones corrigen errores y vulnerabilidades.
Haz copias de seguridad periódicas: tanto de archivos como de la base de datos. Guárdalas en un lugar distinto a tu hosting.
Realiza cambios con cuidado: antes de instalar un módulo o cambiar la configuración, haz una copia de seguridad.
No uses módulos piratas: son la principal fuente de errores y problemas de seguridad.
Monitoriza tu tienda: puedes usar herramientas gratuitas como UptimeRobot para saber si tu tienda se cae.

Conclusión

Los errores de PrestaShop, ya sea el temido error 500 o la página en blanco, tienen solución en la gran mayoría de los casos. La clave está en ser metódico: activa el modo debug, revisa el .htaccess, los permisos, la memoria PHP y la caché. Con esta guía, ya tienes un plan de acción claro para resolver los errores PrestaShop solución más comunes.

Recuerda que si te sientes abrumado, siempre puedes recurrir a un profesional o al soporte de tu hosting. Pero te aseguro que con paciencia y siguiendo estos pasos, la mayoría de las veces podrás arreglarlo tú mismo y ahorrarte una buena suma de dinero.

Espero que esta guía te haya sido de gran ayuda. Si te ha servido, compártela con otros dueños de tiendas PrestaShop que estén pasando por el mismo calvario. ¡Buena suerte con tu tienda!