Errores PrestaShop: Guía para solucionarlos fácilmente

Primero, respira: los errores 500 y 503 en PrestaShop son más comunes de lo que crees

Si estás leyendo esto, probablemente acabas de intentar entrar a tu tienda online y te has encontrado con una pantalla en blanco, un mensaje de "Error 500 Internal Server Error" o un "Servicio no disponible (503)". Tranquilo, respira hondo. No significa que hayas perdido tus productos, tus clientes o tu configuración. En la gran mayoría de los casos, estos errores son problemas de configuración, de permisos de archivos o de recursos del servidor que tienen solución clara y paso a paso.

En esta guía completa, vamos a desglosar los errores más frecuentes en PrestaShop, qué los causa y, lo más importante, cómo solucionarlos tú mismo sin necesidad de ser un gurú de la programación. Te enseñaré a activar el modo depuración PrestaShop, a leer los logs PrestaShop y a aplicar correcciones prácticas. Vamos a ello.

¿Por qué aparecen los errores PrestaShop?

Antes de lanzarnos a arreglar nada, es útil entender de dónde vienen estos problemas. PrestaShop es una aplicación PHP que necesita interactuar con una base de datos (MySQL/MariaDB) y con el sistema de archivos del servidor. Cuando algo falla en esta cadena, el sistema no sabe cómo reaccionar y muestra un error genérico.

Estas son las causas más habituales:

Permisos de archivos incorrectos: El servidor necesita poder leer y escribir en ciertos directorios (como var/cache, img/tmp o config). Si los permisos son demasiado restrictivos, se produce un error 500.
Problemas de memoria PHP: Si tu tienda crece o instalas un módulo pesado, es fácil superar el límite de memoria PHP permitido. Esto provoca un error 500 o una pantalla en blanco.
Errores en un módulo o tema: Un módulo recién actualizado o un tema mal codificado pueden lanzar una excepción que rompe toda la página.
Sobrecarga del servidor: El error 503 suele estar relacionado con el servidor web (Apache o Nginx) o con el panel de control. Si tu web recibe mucho tráfico o el servidor está saturado, puede mostrar este mensaje.
Problemas con la base de datos: Una conexión fallida, una tabla corrupta o un prefijo de tabla incorrecto en parameters.php también son culpables comunes.
Archivos .htaccess corruptos: Este archivo es vital para las URL amigables de PrestaShop. Si se corrompe, la tienda no carga.

Activar el modo depuración PrestaShop: tu mejor amigo

Cuando te encuentras un error 500 genérico, la pantalla no te dice nada útil. Es como si tu coche no arrancara y el salpicadero solo mostrara un "ERROR" sin más. Para obtener el diagnóstico real, necesitas activar el modo depuración PrestaShop. Esto hará que en lugar de un mensaje genérico, veas el error exacto de PHP, la línea y el archivo donde ocurre.

Método 1: A través del archivo `config/defines.inc.php` (el más fiable)

Este método funciona siempre, incluso si no puedes acceder al panel de administración.

Accede a tu hosting vía FTP (por ejemplo, con FileZilla) o a través del administrador de archivos de tu panel de control.
Navega hasta la carpeta raíz de tu tienda (donde están carpetas como admin, themes, img, etc.).
Entra en la carpeta config.
Busca el archivo defines.inc.php y descárgalo a tu ordenador (o edítalo directamente con el editor de texto del panel).
Abre el archivo y busca esta línea (normalmente al principio del archivo):

define('_PS_MODE_DEV_', false);

Cámbiala por esta otra:

define('_PS_MODE_DEV_', true);

Guarda el archivo y súbelo de nuevo a la carpeta config (si lo habías descargado).
Ahora, recarga tu tienda. Verás en pantalla el error real de PHP, con detalles como "Fatal error: Uncaught Error: Call to undefined function..." o similar. Anota ese mensaje, es oro puro para diagnosticar.

[WARNING] No dejes el modo depuración activado para siempre. Es una puerta abierta a que se muestre información sensible de tu servidor a los visitantes. Cuando termines de arreglar el problema, repite los pasos y vuelve a poner _PS_MODE_DEV_ en false.

Método 2: Desde el Panel de Administración

Si tienes acceso al back-office, puedes activarlo desde ahí, pero es un poco "huevo y gallina". Si el error te deja entrar al admin, genial.

Ve a Parámetros avanzados > Rendimiento.
En la sección Modo de depuración, selecciona "Sí" en la opción "Activar el modo de depuración".
Guarda los cambios.

El error 500 en PrestaShop: El rey de los fallos

El error 500 PrestaShop es el más frustrante porque es un cajón de sastre. Significa que el servidor encontró un error interno pero no puede especificar cuál. Sin embargo, con el modo depuración activado, la cosa cambia. Vamos a ver las soluciones más efectivas para las causas típicas.

Solución 1: Limpiar la caché (el clásico)

PrestaShop guarda archivos de caché para acelerar la carga. A veces, estos archivos se corrompen.

Con tu cliente FTP, ve a la carpeta var/cache (en versiones antiguas era cache).
Dentro, verás subcarpetas con nombres como dev o prod. Entra en la que corresponda a tu entorno (normalmente prod).
Borra TODO el contenido de esa carpeta, pero no la carpeta en sí. Si tu FTP te lo impide, borra los archivos uno a uno.
Recarga tu tienda.

[TIP] Si no puedes borrar los archivos, es un problema de permisos. Deberás cambiar los permisos de la carpeta var/cache a 755 (lectura y ejecución) y los archivos a 644. Consúltalo con tu proveedor de hosting si no sabes cómo.

Solución 2: Revisar los permisos de archivos y carpetas

Los permisos en Linux son cruciales. Una regla general para PrestaShop es:

Carpetas (directorios): Permisos 755.
Archivos: Permisos 644.
Archivos de configuración específicos (como config/settings.inc.php en versiones antiguas o app/config/parameters.php en las nuevas): Permisos 444 (solo lectura) o 644 dependiendo de la configuración del hosting.

Para cambiarlos:

En FileZilla, selecciona todos los archivos y carpetas de la raíz.
Haz clic derecho y selecciona "Permisos de archivos...".
Introduce el valor 755 para directorios y 644 para archivos.
Marca la casilla "Recursivo en subdirectorios" y elige "Aplicar a todos los archivos y directorios" si es posible. O hazlo en dos pasos (primero directorios, luego archivos).

Solución 3: Aumentar el límite de memoria PHP

Si el error menciona "Allowed memory size of X bytes exhausted", este es tu problema.

Busca el archivo php.ini en la raíz de tu hosting (si no existe, créalo).
Añade o modifica esta línea:

memory_limit = 512M

Si no tienes acceso a php.ini, puedes intentar añadir esta línea al archivo .htaccess de la raíz:

php_value memory_limit 512M

Guarda y recarga.

Solución 4: Regenerar el archivo `.htaccess`

Un .htaccess dañado es un dolor de cabeza.

Ve a tu panel de administración (si puedes).
Ve a Parámetros avanzados > URL y redireccionamientos.
En la sección "Generar el archivo .htaccess", haz clic en "Guardar" o en el botón de regenerar.
Si no puedes entrar al admin, descarga el .htaccess por FTP, renómbralo a .htaccess_bak (por seguridad) y crea uno nuevo vacío. Luego, desde el admin, regenéralo.

El error 503 en PrestaShop: El servicio no está disponible

El error 503 PrestaShop es diferente al 500. Significa que el servidor está en mantenimiento o saturado. No es un error de tu código, sino del entorno.

Solución 1: Activar y desactivar el modo mantenimiento

A veces, PrestaShop se queda "atascado" en modo mantenimiento.

Ve a Parámetros avanzados > Mantenimiento.
Asegúrate de que "Activar o desactivar la tienda" esté en "No" (tienda activa).
Guarda.

Solución 2: Comprobar la sobrecarga del servidor

Si el error 503 persiste y no es por mantenimiento, tu servidor podría estar sobrecargado. Esto es común en hosting compartido.

Revisa el uso de CPU y memoria: Entra al panel de control de tu hosting (cPanel, Plesk, o Syspanel – recuerda que el puerto de acceso es el 2106 para este último) y mira los gráficos de recursos.
Desactiva módulos pesados: Si tienes módulos de búsqueda en vivo, comparación de productos o plugins de caché muy agresivos, pruébalos desactivando temporalmente.
Contacta con tu proveedor: Si el problema es recurrente, quizás necesites un plan con más recursos.

Solución 3: Problemas con el servidor web (Apache/Nginx)

Si el error 503 viene directamente del servidor web (a veces verás una página de error de Apache o Nginx), puede ser un problema de configuración del propio servidor. En este caso, la solución no está en tu tienda, sino en el servidor. Si usas Syspanel, revisa el estado de los servicios web desde su interfaz o reinícialos si tienes acceso. Si no, contacta con soporte.

Leer los logs PrestaShop: El detective definitivo

Si el modo depuración no te da la solución o quieres ver el historial de errores, los logs PrestaShop son tu siguiente paso.

Logs de PrestaShop: En el back-office, ve a Informar > Registros (Logs). Aquí verás una tabla con los errores registrados por la aplicación.
Logs del servidor: Son los más útiles. Dependiendo del panel de control:
- cPanel/Plesk: Busca la sección "Registros de errores" o "Error Logs".
- Syspanel: Dentro de tu panel, busca la sección de logs del servidor web (Apache/Nginx). El puerto de acceso a Syspanel es el 2106, recuerda.
- Acceso por SSH: Si tienes acceso, puedes ejecutar tail -f /var/log/apache2/error.log o tail -f /var/log/nginx/error.log para ver los errores en tiempo real.

Estos logs te dirán la ruta exacta del archivo y la línea del error, lo que reduce enormemente el tiempo de búsqueda.

Preguntas Frecuentes (FAQ) sobre errores en PrestaShop

1. ¿Por qué mi 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 PHP o de PrestaShop. Prueba a desactivar el módulo. Si no puedes entrar al admin, usa FTP para renombrar la carpeta del módulo en /modules/nombre_modulo (cambia el nombre a nombre_modulo_bak). Esto lo desactivará.

2. El error 500 solo aparece en la página de inicio, pero el admin funciona. ¿Qué hago?

El problema suele estar en el tema o en los módulos del home. Activa el modo depuración PrestaShop para ver el error exacto. Si es de un módulo del home, desactívalo desde el admin.

3. He activado el modo depuración y veo un error de SQL. ¿Qué significa?

Significa que una consulta a la base de datos ha fallado. Puede ser una tabla corrupta. Accede a phpMyAdmin desde tu panel de control, selecciona la base de datos de PrestaShop y en la pestaña "Operaciones" elige "Optimizar tablas" o "Reparar tablas" para las que estén dañadas.

4. ¿Cómo puedo saber si mi hosting es el problema del error 503?

Si el error 503 aparece en otras webs del mismo servidor o si al contactar con tu proveedor te dicen que hay una sobrecarga general, entonces es un problema de hosting. Los errores 503 suelen ser más de infraestructura que de código.

5. ¿Qué es el archivo `parameters.php` y por qué causa errores?

Es el archivo de configuración principal de tu tienda en versiones modernas de PrestaShop. Contiene la conexión a la base de datos. Si tiene datos incorrectos (usuario, contraseña, nombre de BD), la tienda no funcionará. Asegúrate de que los datos son correctos y que el archivo tiene permisos de solo lectura (444) después de configurarlo.

Resumen y consejos finales

Hemos recorrido un largo camino. Para resumir, ante un error en PrestaShop:

Activa el modo depuración PrestaShop (_PS_MODE_DEV_ a true).
Lee el error que aparece en pantalla.
Limpia la caché (var/cache).
Revisa los permisos de archivos y carpetas.
Revisa los logs PrestaShop y los logs del servidor.

[INFO] La mayoría de los errores "mortales" se solucionan con una simple limpieza de caché o un ajuste de permisos. No te asustes antes de tiempo.

Espero que esta guía te haya sido de gran ayuda. Los errores en PrestaShop son un rito de iniciación para cualquier administrador de tiendas online. Con paciencia y estas herramientas, podrás resolverlos tú mismo y, con el tiempo, aprenderás a prevenirlos. Si te quedas atascado, no dudes en buscar ayuda profesional, pero ahora ya tienes una base sólida para empezar a investigar. ¡Mucha suerte con tu tienda!