Errores comunes PrestaShop en cPanel | Guía de solución

¿Por qué aparecen errores en PrestaShop cuando lo gestionas desde cPanel?

Cuando trabajas con una tienda online basada en PrestaShop, es muy habitual que, tarde o temprano, te encuentres con pantallas en blanco, mensajes de error o páginas que no cargan. La mayoría de estos problemas no son graves y se pueden solucionar en pocos minutos si sabes dónde mirar. En este artículo vamos a explicarte, paso a paso y con un lenguaje muy sencillo, cómo solucionar los errores PrestaShop cPanel más comunes: el temido error 500 PrestaShop, el error 404 PrestaShop y otros fallos típicos que aparecen al gestionar tu tienda desde el panel de control de tu hosting.

No necesitas ser un experto en programación. Solo necesitas calma, seguir las instrucciones y tener acceso a tu cPanel. Vamos a ello.

¿Qué significa el error 500 en PrestaShop y cómo solucionarlo?

El error 500 PrestaShop es, sin duda, uno de los más frecuentes y también uno de los que más asustan a los usuarios. La buena noticia es que, en la mayoría de los casos, no se ha perdido información y tu tienda sigue intacta. Este error significa que algo falló en el servidor, pero no te dice exactamente qué es. Por eso, lo primero que debes hacer es investigar.

1. Activa el modo debug de PrestaShop para ver el error real

PrestaShop, por defecto, oculta los detalles técnicos de los errores para proteger tu tienda. Pero tú puedes activar un "modo de depuración" que te mostrará el mensaje exacto. Para hacerlo, necesitas editar un archivo llamado defines.inc.php.

Sigue estos pasos:

Entra a tu cPanel.
Abre el Administrador de archivos.
Navega hasta la carpeta config dentro de la raíz de tu PrestaShop (normalmente public_html).
Busca el archivo defines.inc.php.
Haz clic derecho sobre él y selecciona Editar.
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala por define('_PS_MODE_DEV_', true);.
Guarda los cambios.

Ahora, recarga tu tienda. Verás un mensaje en pantalla con el error específico. Puede ser un problema de memoria, de un módulo, de una plantilla, etc. Una vez que lo sepas, puedes desactivar el modo debug volviendo a poner false en el archivo.

[INFO] Si no encuentras el archivo defines.inc.php, revisa que estás en la carpeta correcta. Si tu tienda está en una subcarpeta (por ejemplo, public_html/tienda), navega hasta ahí.

2. Aumenta el límite de memoria PHP

Uno de los motivos más habituales del error 500 PrestaShop es que el servidor se queda sin memoria para ejecutar los scripts de la tienda. Esto es especialmente común si has instalado muchos módulos o si tu catálogo es muy grande.

Para solucionarlo, debes aumentar el límite de memoria. Puedes hacerlo desde el cPanel:

Ve a la sección Seleccionar versión de PHP (o "MultiPHP Manager").
Haz clic en Opciones de PHP o "Switch to PHP Options".
Busca la variable memory_limit.
Cámbiala a 256M o incluso 512M.
Guarda los cambios.

Si no encuentras esta opción, también puedes crear un archivo llamado php.ini en la raíz de tu tienda y poner dentro:

memory_limit = 512M
max_execution_time = 300

[TIP] Después de cambiar esto, es recomendable vaciar la caché de PrestaShop desde el panel de administración (Parámetros avanzados > Rendimiento).

3. Comprueba los permisos de archivos y carpetas

Otra causa muy común del error 500 PrestaShop son los permisos incorrectos. Si algún archivo o carpeta tiene permisos demasiado restrictivos, el servidor no puede leerlos y provoca el error.

Desde cPanel, ve al Administrador de archivos, selecciona todos los archivos y carpetas de tu tienda y asegúrate de que tengan los siguientes permisos:

Carpetas: 755
Archivos: 644
El archivo config/settings.inc.php (si existe): 444

Si no sabes cómo cambiarlos, selecciona todo, haz clic en Permisos y ajusta los valores. Esto suele resolver muchos problemas.

¿Cómo arreglar el error 404 en PrestaShop?

El error 404 PrestaShop significa que no se encuentra la página que buscas. Esto puede pasar por varias razones, pero las más comunes son: una mala configuración de las URLs amigables, un archivo .htaccess dañado o que hayas movido la tienda de carpeta.

1. Regenera el archivo .htaccess

El archivo .htaccess es el que le dice al servidor cómo manejar las URLs de PrestaShop. Si está dañado o desactualizado, aparecerán errores 404 en todas las páginas excepto la principal.

Para regenerarlo:

Entra al panel de administración de PrestaShop.
Ve a Parámetros avanzados > URL y tráfico.
Haz clic en el botón Guardar (aunque no hayas cambiado nada). Esto fuerce la regeneración del .htaccess.

Si no puedes acceder al panel de administración, hazlo manualmente:

Ve al Administrador de archivos de cPanel.
Busca el archivo .htaccess en la raíz de tu tienda.
Si existe, renómbralo a .htaccess.bak (así lo desactivas).
Ahora, intenta acceder a tu tienda. PrestaShop debería generar un nuevo .htaccess automáticamente.

[WARNING] No borres el .htaccess sin hacer una copia. Si algo sale mal, podrás restaurarlo.

2. Reconfigura las URLs amigables

Si el problema persiste, puede que las URLs amigables estén mal configuradas. Ve a Parámetros avanzados > URL y tráfico y asegúrate de que la opción "URLs amigables" esté activada. Luego, guarda los cambios.

3. Comprueba que la tienda está en la carpeta correcta

Si has movido PrestaShop de carpeta (por ejemplo, de public_html/tienda a public_html), es muy probable que tengas errores 404. En este caso, deberás actualizar la URL de la tienda en la base de datos. Puedes hacerlo desde el panel de administración en Parámetros avanzados > URL y tráfico, o si no tienes acceso, desde phpMyAdmin en cPanel.

En phpMyAdmin, busca la tabla ps_shop_url y actualiza los campos domain y physical_uri con la nueva ubicación.

[INFO] Si no sabes usar phpMyAdmin, pide ayuda a tu proveedor de hosting. Es un cambio delicado.

Otros errores comunes de PrestaShop en cPanel

Además del 500 y el 404, hay otros fallos que aparecen con frecuencia. Te contamos cómo resolverlos.

Error de conexión a la base de datos

Este error suele aparecer como "Error de conexión a la base de datos" o "Link to database cannot be established". Significa que PrestaShop no puede conectarse a MySQL.

Para solucionarlo:

Ve a cPanel y abre Bases de datos MySQL.
Comprueba que la base de datos y el usuario existen.
Verifica que el usuario tiene todos los privilegios sobre la base de datos.
Revisa el archivo config/settings.inc.php y asegúrate de que los datos de conexión (nombre de base, usuario y contraseña) son correctos.

[TIP] Si has cambiado la contraseña de la base de datos recientemente, actualízala también en el archivo settings.inc.php.

Pantalla en blanco al acceder al panel de administración

A veces, la tienda funciona pero el panel de administración muestra una pantalla blanca. Esto suele deberse a un problema con la caché de Smarty o con un módulo incompatible.

Solución rápida:

Desde el Administrador de archivos de cPanel, ve a la carpeta var/cache (o cache en versiones antiguas).
Borra todo el contenido de la carpeta cache y var/cache, excepto el archivo index.php.
Recarga el panel.

Si sigue sin funcionar, desactiva temporalmente los módulos. Puedes hacerlo desde la base de datos: en la tabla ps_module, cambia el valor de active a 0 para todos los módulos. Luego ve reactivándolos uno a uno para encontrar el culpable.

El error "503 Service Unavailable"

Este error indica que la tienda está en modo mantenimiento o que el servidor está sobrecargado. Si no has activado el mantenimiento manualmente, puede deberse a que una tarea programada (cron) está bloqueando el sistema.

Solución:

Accede al panel de administración.
Ve a Parámetros avanzados > Mantenimiento.
Desactiva el modo mantenimiento.

Si no puedes acceder, contacta con tu hosting para que reinicien los procesos de PHP.

Consejos finales para evitar futuros errores PrestaShop cPanel

Prevenir es mejor que curar. Te dejamos algunos hábitos que te ahorrarán muchos dolores de cabeza:

Haz copias de seguridad periódicas de tu tienda y base de datos. En cPanel puedes usar la herramienta de copias de seguridad o instalar un módulo de backup.
Mantén PrestaShop actualizado a la última versión estable.
No instales módulos o plantillas de fuentes dudosas. Son la principal causa de errores y vulnerabilidades.
Revisa los logs de error. En cPanel, en la sección Métricas > Errores, puedes ver los logs del servidor. Te ayudarán a anticiparte a problemas.

[WARNING] Si usas un panel alternativo como Syspanel, recuerda que el acceso se realiza a través del puerto 2106. Los pasos internos son similares a cPanel, pero la interfaz puede variar ligeramente.

Preguntas frecuentes sobre errores de PrestaShop en cPanel

¿Por qué mi tienda PrestaShop da error 500 después de instalar un módulo?

Esto es muy común. El módulo puede ser incompatible con tu versión de PrestaShop o con tu configuración de PHP. Desactiva el módulo desde la base de datos (tabla ps_module) o desde el panel de administración si puedes acceder.

¿Cómo sé si el error 500 es por el hosting o por PrestaShop?

Revisa los logs de error del servidor. Si ves errores de memoria o de tiempo de ejecución, es probable que sea por configuración de PHP. Si los logs no muestran nada, puede ser un problema de permisos o de archivos.

¿Puedo solucionar el error 404 sin acceso al panel de administración?

Sí, regenerando el .htaccess manualmente o restaurando una copia de seguridad anterior. También puedes usar phpMyAdmin para corregir las URLs en la base de datos.

¿Qué hago si ninguna de estas soluciones funciona?

Contacta con tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden ver el error exacto. A veces, el problema está en la configuración del servidor y no en tu tienda.

Conclusión

Los errores PrestaShop cPanel pueden parecer abrumadores, pero con un poco de método y las herramientas adecuadas, casi todos tienen solución. Recuerda: activa el modo debug para ver el error real, revisa los permisos, regenera el .htaccess y mantén tu tienda actualizada. Con estos pasos, podrás solucionar problemas PrestaShop de forma autónoma y rápida, sin perder ventas ni paciencia.

Esperamos que esta guía te haya sido de ayuda. Si tienes alguna duda, déjala en los comentarios y estaremos encantados de ayudarte. ¡Buena suerte con tu tienda online!