Solución a errores 500 y 404 en PrestaShop en cPanel

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con dos de los errores más comunes (y frustrantes) en una tienda PrestaShop: el temido error 500 y el molesto error 404. No te preocupes, hoy vamos a desglosar, paso a paso, cómo solucionarlos desde tu panel de control cPanel. Al final de este artículo, tendrás las herramientas para diagnosticar y reparar estos problemas tú mismo, sin necesidad de ser un experto en programación.

Vamos a empezar por entender qué significan estos errores, y luego pasaremos a las soluciones prácticas. Recuerda que la paciencia y el orden son tus mejores aliados.

¿Qué es un Error 500 en PrestaShop y por qué aparece en cPanel?

El error 500, también conocido como "Error interno del servidor", es como un "cajón desastre" de los errores. Significa que algo falló en el servidor, pero el servidor no te da detalles específicos. En PrestaShop, las causas más frecuentes son:

• Archivos con permisos incorrectos.
• Un archivo .htaccess corrupto o mal configurado.
• Un módulo o tema defectuoso que provoca un conflicto.
• Límite de memoria PHP excedido.
• Un archivo PHP dañado (por ejemplo, durante una actualización).

Paso 1: Activar el modo debug de PrestaShop (la linterna en la oscuridad)

Antes de tocar nada, necesitamos que PrestaShop nos diga exactamente qué está mal. Por defecto, los errores se ocultan. Para verlos, debemos activar el modo debug.

1. Accede a tu cPanel. Busca la sección "Archivos" y haz clic en Administrador de archivos.
2. Navega hasta la carpeta raíz de tu tienda PrestaShop (normalmente public_html o una subcarpeta).
3. Busca el archivo config/defines.inc.php.
4. Haz clic derecho sobre él y selecciona Editar.
5. Busca la línea que dice: define('_PS_MODE_DEV_', false);
6. Cámbiala por: define('_PS_MODE_DEV_', true);
7. Guarda los cambios.

[WARNING] Una vez que hayas solucionado el error, vuelve a poner false en esa línea. Dejar el modo debug activado en una tienda en producción expone información sensible a los visitantes.

Ahora, al recargar tu tienda, en lugar del error 500 genérico, verás un mensaje de error específico (por ejemplo, "Fatal error: Allowed memory size of..."). Ese mensaje es oro puro para la solución.

Paso 2: Soluciones rápidas para el Error 500

Aquí tienes una lista de acciones, ordenadas de la más simple a la más compleja, que suelen resolver el 90% de los casos.

Aumentar el límite de memoria PHP

Si el error dice algo como "Allowed memory size exhausted", tu tienda necesita más memoria.

1. En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP (o "MultiPHP Manager").
2. Una vez dentro, busca la opción Switch to PHP Options o similar.
3. Localiza la directiva memory_limit y cámbiala a un valor más alto, por ejemplo, 256M o 512M.
4. Guarda los cambios y recarga tu tienda.

Regenerar o eliminar el archivo .htaccess

Un archivo .htaccess corrupto es una causa muy común del error 500 PrestaShop cPanel. Vamos a regenerarlo.

1. En el Administrador de archivos de cPanel, ve a la raíz de tu tienda.
2. Busca el archivo .htaccess (puede estar oculto; activa la opción "Mostrar archivos ocultos" en la parte superior derecha).
3. Haz una copia de seguridad: haz clic derecho sobre él y selecciona Copiar. Ponle nombre como .htaccess.backup.
4. Luego, elimina el archivo original (.htaccess).
5. Ahora, ve al Back Office de PrestaShop (si puedes acceder). Si no, tendrás que regenerarlo manualmente.
6. Para regenerarlo desde el Back Office: Ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs. En la parte inferior, haz clic en Guardar (aunque no hayas cambiado nada). Esto regenera el .htaccess.
7. Si no puedes acceder al Back Office, crea un archivo .htaccess vacío desde el Administrador de archivos (clic derecho > Nuevo archivo) y luego pégalo en la raíz. Después, intenta acceder al Back Office para regenerarlo.

[TIP] Si al eliminar el .htaccess tu tienda vuelve a funcionar (aunque las URLs no sean amigables), el problema estaba ahí. La regeneración lo solucionará.

Revisar permisos de archivos y carpetas

Los permisos incorrectos (por ejemplo, archivos con permisos 777) pueden causar errores 500.

1. En el Administrador de archivos, selecciona toda la carpeta de tu tienda (o la carpeta public_html).
2. Haz clic en Permisos en la barra de herramientas.
3. Asegúrate de que los directorios (carpetas) tengan permisos 755 y los archivos tengan permisos 644.
4. Marca la casilla "Cambiar los permisos de los subdirectorios y archivos recursivamente" y aplica.

Paso 3: Cómo solucionar el Error 404 en PrestaShop

El error 404 ("Página no encontrada") es más específico. Significa que el servidor encontró tu tienda, pero no la página que buscas. Las causas típicas son:

• URLs amigables mal configuradas o un .htaccess obsoleto.
• Enlaces rotos dentro de tu tienda.
• Módulos de redirección o SEO mal configurados.
• Eliminación accidental de una página o categoría.

Regenerar el .htaccess (de nuevo, pero con cariño)

Sí, el .htaccess es el principal sospechoso también aquí. Sigue los pasos del punto anterior (eliminar y regenerar desde el Back Office). Esto suele resolver el error 404 PrestaShop de inmediato si el problema son las URLs amigables.

Reconstruir el índice de URLs

PrestaShop guarda un índice de todas las URLs para que sean rápidas. A veces ese índice se desactualiza.

1. Ve al Back Office.
2. Navega a Parámetros de la tienda > Rendimiento.
3. En la sección "Plantillas de caché", haz clic en "Forzar compilación" y luego en "Vaciar la caché".
4. También, en la sección "Caché de consultas", actívala y desactívala (o viceversa) para forzar su reinicio. Guarda los cambios.

Verificar la configuración de URL amigable

1. Ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs.
2. Asegúrate de que la opción "URLs amigables" esté activada (sí, en verde).
3. Desplázate hasta la parte inferior y haz clic en Guardar para regenerar las reglas.

[INFO] Si tu servidor no tiene instalado el módulo mod_rewrite de Apache, las URLs amigables no funcionarán. Puedes verificar esto en cPanel > Software > Apache mod_status (si está disponible) o preguntando a tu proveedor de hosting.

FAQ: Preguntas Frecuentes sobre errores en PrestaShop

P: ¿Qué hago si después de todo esto sigo viendo el error 500?
R: Si el modo debug no te da información, el problema puede ser un módulo o tema. Desactiva todos los módulos no esenciales desde el Back Office (o renombra la carpeta /modules a /modules_old para desactivarlos todos a la vez). Si el error desaparece, reactívalos uno por uno para encontrar el culpable.

P: ¿El error 404 puede ser por un enlace externo roto?
R: Sí, pero eso no es un error de tu servidor, sino de contenido. Puedes usar herramientas como "Google Search Console" o plugins de SEO para encontrar y redirigir esos enlaces rotos.

P: ¿Cómo puedo hacer una copia de seguridad antes de hacer cambios?
R: ¡Excelente pregunta! Siempre haz una copia de seguridad. En cPanel, busca la sección Archivos y haz clic en Copias de seguridad. Puedes descargar una copia completa de tu sitio (incluyendo la base de datos) antes de empezar a experimentar.

P: Mencionaste "Syspanel" antes, ¿qué es?
R: En algunos entornos, el panel de control se llama Syspanel en lugar de cPanel. Si tienes Syspanel, el puerto de acceso suele ser el 2106 (ejemplo: tu-dominio.com:2106). Los pasos para solucionar errores son prácticamente los mismos, solo cambia la interfaz gráfica. Busca las secciones de "Archivos" y "Base de datos" para realizar las mismas operaciones.

Resumen y consejos finales

Solucionar errores PrestaShop no tiene por qué ser una pesadilla. Recuerda esta checklist rápida:

1. Activa el modo debug para ver el error real.
2. Aumenta la memoria PHP si es necesario.
3. Regenera el .htaccess (es la solución mágica para ambos errores).
4. Revisa los permisos de archivos (755 para carpetas, 644 para archivos).
5. Desactiva módulos para descartar conflictos.
6. Limpia la caché desde el Back Office.

Si has seguido todos estos pasos y el problema persiste, puede ser un error más profundo del servidor (como una versión de PHP incompatible con tu PrestaShop o un problema en la base de datos). En ese caso, contacta a tu proveedor de hosting y muéstrales el mensaje de error exacto que obtuviste con el modo debug.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la clave está en la calma y en seguir los pasos de forma ordenada. ¡Tu tienda volverá a funcionar en poco tiempo!