Errores comunes PrestaShop cPanel: 500, 403, 404 soluciones

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, es muy probable que tu tienda PrestaShop esté mostrando alguno de esos molestos errores HTTP: el temido error 500, el frustrante error 403 o el desesperante error 404. No te preocupes, son problemas muy comunes cuando gestionamos una tienda online, especialmente si usas cPanel como panel de control de tu hosting.

En esta guía extensa y súper fácil de seguir, vamos a desglosar cómo solucionar errores PrestaShop paso a paso. Te prometo que no necesitas ser un experto en programación. Solo sigue las instrucciones al pie de la letra y, en la mayoría de los casos, tu tienda volverá a la vida en minutos.

Vamos a centrarnos en tres errores muy específicos:

Error 500 (Internal Server Error): El clásico "pantallazo blanco" o mensaje genérico. Es el más común y normalmente indica un problema en el servidor o en la configuración de PrestaShop.
Error 403 (Forbidden): Te dice que no tienes permiso para acceder a un archivo o carpeta. Suele ser un problema de permisos de archivos.
Error 404 (Not Found): La página que buscas no existe. Puede deberse a un enlace roto, una mala configuración de la URL amigable (SEO) o un problema con el archivo .htaccess.

Solucionar el Error 500 en PrestaShop desde cPanel

El error 500 PrestaShop cPanel es el más frustrante porque a menudo no da detalles. Pero no te preocupes, aquí tienes las soluciones más efectivas.

¿Qué causa el Error 500?

Generalmente, es un problema de:

Módulos o temas incompatibles: Instalaste algo nuevo y rompió la tienda.
PHP Memory Limit (Límite de memoria PHP): Tu tienda necesita más memoria de la que el servidor le asigna.
Archivo .htaccess corrupto: Este archivo es vital para las URL amigables y la seguridad. Si se daña, todo falla.
Permisos de archivos incorrectos.

Paso 1: Activar el modo debug de PrestaShop (¡IMPORTANTE!)

Para saber exactamente qué está pasando, debemos activar el modo de depuración. Esto mostrará el error real en lugar de la pantalla genérica.

Accede a tu cPanel (normalmente tudominio.com/cpanel).
Busca el Administrador de Archivos (File Manager).
Ve a la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta).
Busca el archivo config/defines.inc.php.
Haz clic derecho sobre él y selecciona Editar.
Busca la siguiente línea (aproximadamente en la línea 30):
define('_PS_MODE_DEV_', false);
Cámbiala por:
define('_PS_MODE_DEV_', true);
Guarda el archivo.
Ahora, recarga tu tienda. En lugar del error 500, verás un mensaje de error específico (por ejemplo, "Fatal error: Allowed memory size exhausted" o "Class not found"). Copia ese mensaje, nos ayudará luego.

[WARNING] No dejes el modo debug activado en una tienda en producción (pública). Una vez solucionado el error, vuelve a poner false.

Paso 2: Aumentar el límite de memoria PHP

Si el error dice algo como Allowed memory size of X bytes exhausted, necesitas aumentar la memoria.

En tu cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP (o MultiPHP Manager).
Verás una lista de opciones. Busca memory_limit.
Cambia el valor. Recomiendo empezar con 256M o incluso 512M si tu tienda es grande.
Haz clic en Aplicar.
Desactiva el modo debug (vuelve a poner false en el paso 1) y prueba tu tienda.

Paso 3: Regenerar el archivo .htaccess

Un .htaccess dañado es una causa muy común del error 500.

En el Administrador de Archivos de cPanel, ve a la raíz de tu tienda.
Busca el archivo .htaccess (puede estar oculto; si no lo ves, haz clic en Configuración y marca Mostrar archivos ocultos).
Renómbralo a algo como htaccess_backup.txt. Esto lo desactivará temporalmente.
Ahora, ve al Back Office de PrestaShop (intenta acceder escribiendo tudominio.com/admin). Si no puedes, ve al paso siguiente.
Una vez dentro del Back Office, ve a Configuración de la tienda -> Parámetros generales.
En la pestaña SEO y URLs, haz clic en el botón Guardar (sin cambiar nada). Esto regenerará automáticamente el archivo .htaccess.
Vuelve a probar tu tienda. Si funciona, ¡problema resuelto!

Paso 4: Deshabilitar módulos problemáticos (sin acceso al Back Office)

Si el error 500 te impide incluso entrar al Back Office, puedes deshabilitar módulos manualmente.

En el Administrador de Archivos, ve a la carpeta /modules de tu tienda.
Busca la carpeta del módulo que instalaste justo antes de que empezara el error.
Renómbrala (por ejemplo, mimodulo a mimodulo_off). Esto lo desactivará.
Prueba tu tienda. Si funciona, ese módulo era el culpable. Puedes borrarlo o buscar una actualización.

Solucionar el Error 403 en PrestaShop

El error 403 PrestaShop significa "Prohibido". El servidor te está negando el acceso a algo. Normalmente es un problema de permisos.

¿Qué causa el Error 403?

Permisos de archivos incorrectos: Los archivos y carpetas deben tener permisos específicos para que el servidor web (Apache) pueda leerlos y ejecutarlos.
Archivo .htaccess con reglas restrictivas: A veces, una regla de seguridad mal escrita bloquea todo.
Problemas con el certificado SSL o redirecciones.

Paso 1: Verificar y corregir permisos de archivos

Esta es la solución más común.

En el Administrador de Archivos de cPanel, selecciona la carpeta raíz de tu tienda (por ejemplo, public_html).
Haz clic en Seleccionar todo (o Ctrl+A).
Haz clic derecho y selecciona Cambiar permisos.
Aplica los siguientes valores estándar:
- Carpetas: 755 (o 0755)
- Archivos: 644 (o 0644)
Marca la casilla Recursivo (para que se aplique a todas las subcarpetas y archivos).
Haz clic en Cambiar permisos.
Prueba tu tienda de nuevo.

[TIP] Si tienes problemas con la subida de imágenes, asegúrate de que la carpeta /img y sus subcarpetas tengan permisos 755.

Paso 2: Revisar el .htaccess por reglas de bloqueo

Si los permisos están bien, el problema puede estar en el .htaccess.

Abre el archivo .htaccess en el editor de texto.
Busca líneas que empiecen con Deny from all, Require all denied o RewriteRule que bloqueen IPs o directorios.
Si ves algo como <Files ...>, asegúrate de que no esté bloqueando archivos PHP o JS importantes.
Si no estás seguro, renombra el archivo como hicimos antes y prueba. Si el error 403 desaparece, el .htaccess es el culpable. Regenera uno nuevo desde el Back Office.

Solucionar el Error 404 en PrestaShop

El error 404 PrestaShop indica que la página solicitada no se encuentra. Es muy común después de migrar una tienda o cambiar la configuración de las URL.

¿Qué causa el Error 404?

URLs amigables mal configuradas: La opción "URLs amigables" de PrestaShop no está activada o el .htaccess no se ha regenerado.
Enlaces rotos: Has cambiado la URL de un producto o categoría.
Problemas con el archivo .htaccess (de nuevo).
Mala configuración del servidor web.

Paso 1: Activar y regenerar URLs amigables

Accede a tu Back Office de PrestaShop.
Ve a Configuración de la tienda -> Parámetros generales -> SEO y URLs.
Asegúrate de que la opción URLs amigables (Friendly URLs) esté en Sí.
Haz clic en Guardar para regenerar el .htaccess.
Limpia la caché de PrestaShop: Ve a Configuración avanzada -> Rendimiento y haz clic en Forzar compilación y Limpiar caché.

Paso 2: Verificar la configuración del servidor (Apache + Nginx)

Algunos servidores usan Apache como servidor web, pero pueden tener un proxy inverso de Nginx. En ese caso, el .htaccess de PrestaShop no funciona correctamente.

Pregunta a tu proveedor de hosting si tu plan usa Apache puro o Nginx + Apache.
Si es Nginx, necesitarás añadir las reglas de reescritura de PrestaShop en el archivo de configuración de Nginx (esto ya es más técnico, pero tu soporte puede ayudarte).

Paso 3: Reconstruir el índice de productos (Si el error es en categorías o productos)

A veces, el error 404 ocurre solo en productos o categorías específicas. Puede ser un problema de la base de datos.

En el Back Office, ve a Configuración avanzada -> Base de datos -> Índices de la base de datos.
Haz clic en Reconstruir todos los índices.
También puedes ir a Configuración de la tienda -> Rendimiento y limpiar la caché de Smarty.

Preguntas Frecuentes (FAQ) sobre errores en PrestaShop

P: ¿Por qué veo un error 500 después de instalar un módulo?
R: Es muy probable que el módulo no sea compatible con tu versión de PrestaShop o de PHP. Desactívalo renombrando su carpeta en /modules (como explicamos antes) y contacta al desarrollador.

P: El error 403 aparece solo en el área de administración (/admin), ¿qué hago?
R: Revisa los permisos de la carpeta /admin. Deben ser 755. También verifica que el archivo config/defines.inc.php no tenga restricciones de IP.

P: He seguido todos los pasos y sigo teniendo el error 404 en todas las páginas.
R: Asegúrate de que tu servidor tenga habilitado el módulo mod_rewrite de Apache. Si usas cPanel, puedes verificarlo en Seleccionar versión de PHP o contactando a tu hosting. Sin mod_rewrite, las URLs amigables no funcionan.

P: Uso Syspanel (HestiaCP) en lugar de cPanel. ¿Cambia algo?
R: No te preocupes. Aunque el panel sea diferente (accede por el puerto 2106, por ejemplo tudominio.com:2106), los archivos y la lógica son los mismos. Busca el Administrador de Archivos en tu Syspanel y sigue los mismos pasos para editar defines.inc.php, .htaccess y los permisos. La estructura de carpetas es idéntica.

P: ¿Es seguro aumentar el límite de memoria PHP a 512M?
R: Sí, es seguro y comúnmente necesario para tiendas con muchos productos, módulos o tráfico. Si tu hosting te lo permite, no hay problema. Si no, contacta a tu proveedor.

Conclusión: No te rindas

Los errores 500, 403 y 404 en PrestaShop son como los resfriados de las tiendas online: molestos, pero casi siempre curables. Con esta guía, tienes las herramientas para diagnosticar y solucionar errores PrestaShop desde tu cPanel.

Recuerda el orden lógico:

Error 500: Activa debug -> Aumenta memoria -> Regenera .htaccess -> Desactiva módulos.
Error 403: Corrige permisos (755/644) -> Revisa .htaccess.
Error 404: Activa URLs amigables -> Regenera .htaccess -> Limpia caché.

Si después de todo esto el problema persiste, no dudes en contactar al soporte técnico de tu hosting. Diles exactamente qué error ves (con el modo debug activado si es posible) y qué pasos has seguido. ¡Ellos te ayudarán encantados!

Espero que esta guía te haya sido de gran ayuda. ¡Tu tienda online volverá a funcionar en poco tiempo!