Errores comunes en PrestaShop | Soluciones fáciles

Introducción: ¿Por qué surgen errores en PrestaShop?

Si tienes una tienda online con PrestaShop, es probable que en algún momento te hayas encontrado con pantallas en blanco, mensajes de error extraños o funcionalidades que dejan de funcionar. No te preocupes: la mayoría de estos problemas tienen soluciones sencillas que puedes aplicar tú mismo, sin necesidad de ser un experto en programación.

En esta FAQ de PrestaShop, vamos a repasar los errores más comunes, sus causas y, lo más importante, cómo solucionarlos paso a paso. Nuestro objetivo es que puedas solucionar problemas PrestaShop de forma rápida y autónoma, manteniendo tu tienda funcionando sin contratiempos.

[INFO] Esta guía está pensada para usuarios de paneles de control como cPanel o Syspanel (accesible por el puerto 2106). Si usas otro panel, los pasos pueden variar ligeramente, pero los conceptos son los mismos.

1. Error “500 Internal Server Error” o pantalla en blanco

Este es uno de los errores PrestaShop más frecuentes. Aparece de repente y no te deja ver nada de tu tienda. Suele deberse a un problema de memoria, un módulo incompatible o un archivo corrupto.

¿Cómo solucionarlo?

Sigue estos pasos en orden:

Accede a tu panel de control (por ejemplo, Syspanel a través del puerto 2106).
Ve al administrador de archivos y localiza la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Busca el archivo config/defines.inc.php y ábrelo con un editor de texto.
Cambia la línea define('_PS_MODE_DEV_', false); por define('_PS_MODE_DEV_', true);.
Guarda los cambios y recarga tu tienda. Ahora verás un mensaje de error detallado que te indicará el problema exacto (por ejemplo, un módulo que falla o un límite de memoria).
Una vez identificado el error, vuelve a poner false en esa línea para evitar mostrar información sensible a los visitantes.

[TIP] Si el error persiste, aumenta el límite de memoria PHP desde la configuración de tu panel. En Syspanel, busca la sección "PHP Settings" y ajusta memory_limit a 256M o 512M.

2. Error “404 Not Found” en páginas de producto o categoría

Cuando haces clic en un producto y te lleva a una página de error 404, es probable que la URL amigable (rewriting) se haya desconfigurado o que el archivo .htaccess esté dañado.

Pasos para resolverlo:

Accede a tu panel de control y ve a la sección de archivos.
Localiza el archivo .htaccess en la raíz de tu PrestaShop. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Renombra el archivo a .htaccess_backup (por si acaso necesitas restaurarlo).
Entra al back office de PrestaShop (tuadmin/).
Ve a Parámetros de la tienda > Tráfico y SEO.
En la pestaña SEO y URLs, desmarca la opción "URLs amigables" y guarda los cambios.
Vuelve a marcar la opción y guarda de nuevo. Esto regenerará el archivo .htaccess automáticamente.

[WARNING] Si después de esto sigues viendo errores 404, revisa que los enlaces en tu menú no tengan caracteres especiales o espacios. También puedes regenerar el archivo .htaccess manualmente desde el panel: en Syspanel, usa la opción "Regenerar .htaccess" en la sección de PrestaShop.

3. Error “No se puede conectar a la base de datos”

Este error aparece cuando PrestaShop pierde la conexión con MySQL. Las causas pueden ser: cambio de contraseña de la base de datos, corrupción de tablas o límite de conexiones.

Solución paso a paso:

Verifica las credenciales en el archivo app/config/parameters.php. Busca las líneas database_host, database_name, database_user y database_password. Asegúrate de que coincidan con los datos de tu base de datos actual.
Accede a tu panel de control (Syspanel, puerto 2106) y entra a phpMyAdmin.
Selecciona tu base de datos y haz clic en "Marcar todas" las tablas.
En el menú desplegable, elige "Reparar tabla". Esto solucionará posibles corrupciones.
Si el error persiste, desde el panel de control, ve a la sección de Base de datos y reinicia el servicio MySQL.

[INFO] Si cambiaste la contraseña de la base de datos recientemente, recuerda actualizarla también en el archivo parameters.php. De lo contrario, PrestaShop no podrá conectarse.

4. Error de actualización: “No se puede completar la actualización”

Al intentar actualizar PrestaShop a una versión más reciente, puede aparecer un mensaje de error que impide continuar. Esto suele deberse a módulos incompatibles o archivos con permisos incorrectos.

¿Qué hacer?

Antes de actualizar, haz una copia de seguridad completa de tu tienda (archivos y base de datos). Puedes usar la herramienta de backup de tu panel: en Syspanel, busca "Backups" y programa uno.
Desactiva todos los módulos que no sean oficiales de PrestaShop. Ve a Módulos > Gestor de módulos y desinstala los de terceros.
Verifica los permisos de carpetas: desde el panel de control, asegúrate de que las carpetas app, config, cache, log y translations tengan permisos 755, y los archivos dentro de ellas 644.
Vuelve a intentar la actualización desde el back office. Si falla de nuevo, descarga el paquete de actualización manual desde el sitio oficial de PrestaShop y súbelo por FTP a la carpeta admin/autoupgrade.

[WARNING] Nunca actualices desde una versión muy antigua (por ejemplo, de 1.6 a 8.0) directamente. Hazlo por pasos: primero a 1.7, luego a 8.0. Si no, corres el riesgo de perder datos.

5. Error “El carrito no se actualiza” o productos que no se añaden

A veces los clientes se quejan de que no pueden agregar productos al carrito, o que el carrito se vacía solo. Esto suele ser un problema de caché o de sesiones.

Soluciones:

Limpia la caché de PrestaShop: desde el back office, ve a Parámetros avanzados > Rendimiento y haz clic en "Limpiar caché" (tanto la de Smarty como la de Symfony).
Borra la carpeta var/cache manualmente desde el administrador de archivos de tu panel. Esto eliminará archivos temporales corruptos.
Verifica la configuración de sesiones en el archivo config/defines.inc.php. Busca define('_PS_COOKIE_SAMESITE_', 'Lax'); y cámbialo a 'None' si usas HTTPS (con cuidado, porque puede tener implicaciones de seguridad).
Prueba con otro navegador o en modo incógnito. Si funciona, el problema es la caché del navegador del cliente, no tu tienda.

[TIP] Si usas un plugin de caché como "PrestaShop Cache" o un CDN, asegúrate de que no esté bloqueando las solicitudes AJAX del carrito. Desactívalo temporalmente para probar.

6. Error de imagen: “No se puede cargar la imagen” o imágenes rotas

Las imágenes de productos que no se ven son un problema común, especialmente después de migrar de servidor o actualizar.

¿Cómo arreglarlo?

Regenera las miniaturas desde el back office: ve a Diseño > Theme > Configuración de imagen y haz clic en "Regenerar miniaturas".
Verifica los permisos de la carpeta img: debe tener permisos 755. Desde tu panel de control (Syspanel), usa el administrador de archivos para ajustarlos.
Revisa la ruta de las imágenes en la base de datos: si migraste, las rutas pueden ser absolutas (ej. /home/usuario/public_html/img/p/...) y deberían ser relativas (/img/p/...). Puedes corregirlo con una consulta SQL en phpMyAdmin.
Si el problema persiste, sube las imágenes manualmente por FTP a la carpeta img/p/ asegurándote de que el nombre del archivo coincida con el ID del producto.

[WARNING] No uses imágenes con nombres muy largos o caracteres especiales (como ñ, tildes o espacios). PrestaShop puede tener problemas para procesarlas.

7. Error de envío de correos: “No se pueden enviar los emails”

Si tu tienda no envía correos de confirmación de pedido o de registro, el problema suele estar en la configuración SMTP.

Solución:

Ve a Parámetros de la tienda > Parámetros generales > Email.
Selecciona "Enviar correos usando SMTP" e ingresa los datos de tu servidor de correo (puedes obtenerlos de tu proveedor de hosting o de Syspanel).
Prueba la configuración con el botón "Enviar un email de prueba". Si falla, prueba con el puerto 587 (TLS) o 465 (SSL).
Si usas Gmail o Outlook, activa el acceso para aplicaciones menos seguras o genera una contraseña específica para la aplicación.
Como último recurso, cambia a "Enviar correos usando la función mail de PHP". Aunque es menos seguro, funciona en la mayoría de los servidores compartidos.

[INFO] Algunos servidores bloquean el puerto 25 por seguridad. Si tu hosting es compartido, pregunta a tu proveedor qué puertos SMTP están permitidos.

8. Error de módulo: “El módulo no se puede instalar” o “Error 500 al activar”

Los módulos son una fuente común de errores PrestaShop. Si no se instalan o causan un error 500 al activarlos, sigue estos pasos:

Verifica la compatibilidad del módulo con tu versión de PrestaShop. En la ficha del módulo, busca "Versiones compatibles".
Descomprime el módulo en tu ordenador y busca archivos con errores de sintaxis. Si ves un archivo .php vacío o con código extraño, el módulo está corrupto.
Sube el módulo manualmente por FTP a la carpeta modules/ de tu tienda. Desde el panel de control (Syspanel), usa el administrador de archivos para copiarlo.
Limpia la caché como se explicó en el punto 5.
Si el error persiste, revisa los logs de error de PHP. En Syspanel, busca la sección "Error Logs" para ver el mensaje exacto.

[WARNING] Nunca instales módulos de fuentes no oficiales. Pueden contener malware o ser incompatibles con tu tienda.

9. Error de migración: “La tienda no carga después de moverla”

Si cambiaste de servidor o de dominio, es posible que la tienda no cargue correctamente. Esto se debe a rutas absolutas en la base de datos.

Solución rápida:

Edita el archivo config/settings.inc.php (en versiones antiguas) o app/config/parameters.php y actualiza las rutas de PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.

Accede a phpMyAdmin y ejecuta esta consulta SQL (reemplaza tuprefijo_ por el tuyo y tudominio.com por el nuevo):

UPDATE tuprefijo_configuration SET value = 'tudominio.com' WHERE name IN ('PS_SHOP_DOMAIN', 'PS_SHOP_DOMAIN_SSL');

Limpia la caché y regenera el archivo .htaccess como vimos antes.
Si usas Syspanel, puedes usar la herramienta "Cambiar dominio" en la sección de PrestaShop para automatizar este proceso.

[TIP] Siempre que migres, asegúrate de que la versión de PHP del nuevo servidor sea compatible con tu PrestaShop. Por ejemplo, PrestaShop 1.7 requiere PHP 7.1 o superior.

10. Error de mantenimiento: “La tienda está en mantenimiento y no puedo acceder”

A veces activas el modo mantenimiento para hacer cambios y luego no puedes acceder ni al back office.

¿Cómo salir?

Accede a tu panel de control (Syspanel, puerto 2106) y ve al administrador de archivos.
Busca el archivo config/defines.inc.php y cambia define('_PS_MAINTENANCE_TOKEN_', '...'); por un token nuevo (puedes generar uno aleatorio).
Guarda el archivo y ahora puedes acceder al back office añadiendo ?token=el_token_que_creaste al final de la URL (ejemplo: tutienda.com/admin1234/?token=abc123).
Una vez dentro, ve a Parámetros de la tienda > Mantenimiento y desactívalo.

[WARNING] No uses el modo mantenimiento como método de seguridad. Siempre cambia la contraseña del admin y usa HTTPS.

Conclusión: Prevenir es mejor que curar

Como has visto, la mayoría de los errores PrestaShop tienen solución y no requieren conocimientos avanzados. La clave está en mantener tu tienda actualizada, hacer copias de seguridad periódicas y monitorizar los logs de error desde tu panel de control (como Syspanel, accesible por el puerto 2106).

Si después de seguir esta FAQ PrestaShop el problema persiste, no dudes en contactar con tu proveedor de hosting. Ellos pueden revisar la configuración del servidor y ayudarte a solucionar problemas PrestaShop más complejos.

Recuerda: una tienda estable es sinónimo de clientes felices. ¡Manos a la obra!