Preguntas frecuentes y errores comunes en PrestaShop | Soluciones

Si estás leyendo esto, probablemente te has encontrado con algún problema al gestionar tu tienda online con PrestaShop. No te preocupes, es más común de lo que crees. Como técnico de soporte, he visto cientos de casos similares y la mayoría tienen una solución sencilla. En esta guía tipo FAQ PrestaShop vamos a repasar los errores PrestaShop más frecuentes, desde la temida página blanca PrestaShop hasta el molesto error base de datos PrestaShop. Te explicaré paso a paso cómo identificarlos y solucionarlos, incluso si no eres un experto en tecnología.

1. ¿Por qué aparece una página en blanco en mi PrestaShop?

La famosa página blanca PrestaShop (también conocida como pantalla en blanco o error 500) es uno de los errores PrestaShop más habituales. Ocurre cuando PHP encuentra un error crítico pero no puede mostrar el mensaje porque la visualización de errores está desactivada.

Causas más comunes:

Límite de memoria de PHP agotado: tu tienda necesita más memoria de la que tiene asignada.
Módulo incompatible: un módulo recién instalado o actualizado está fallando.
Tema defectuoso: el tema que usas tiene un error de código.
Error de sintaxis en un archivo: por ejemplo, al editar manualmente un archivo PHP.

Solución paso a paso:

Paso 1: Activar la visualización de errores (temporalmente)
Para ver qué está pasando realmente, necesitas que PrestaShop te muestre el error. Edita el archivo config/defines.inc.php de tu instalación. Busca esta línea:
define('_PS_MODE_DEV_', false);
Cámbiala a:
define('_PS_MODE_DEV_', true);
Guarda el archivo y recarga tu tienda. Ahora verás un mensaje de error con más detalles.

[WARNING] No dejes el modo desarrollo activado en una tienda en producción. Una vez solucionado el problema, vuelve a ponerlo en false.

Paso 2: Aumentar el límite de memoria de PHP
Si el error menciona "memory exhausted" o "allowed memory size", edita el archivo php.ini de tu servidor (o usa el panel de control). Busca:
memory_limit = 128M
Cámbialo a:
memory_limit = 256M
O incluso 512M si es necesario. Guarda y reinicia el servicio PHP.

Paso 3: Desactivar módulos problemáticos
Si no ves el error con claridad, desactiva todos los módulos no esenciales. Puedes hacerlo desde el panel de administración (si accedes) o renombrando la carpeta modules a modules_old vía FTP. Luego crea una carpeta modules vacía. Esto forzará a PrestaShop a cargar sin módulos. Si la página blanca desaparece, reactiva uno por uno hasta encontrar el culpable.

Paso 4: Cambiar temporalmente al tema por defecto
Si el problema persiste, cambia al tema "classic" o "default-bootstrap". Puedes hacerlo desde el back office (si accedes) o editando la base de datos directamente (consulta la sección de errores de base de datos más abajo).

2. Error de base de datos en PrestaShop: ¿cómo solucionarlo?

El error base de datos PrestaShop suele mostrar mensajes como "Cannot connect to database", "Table doesn't exist" o "SQL error". Generalmente está relacionado con la conexión a MySQL o con la integridad de las tablas.

Causas principales:

Credenciales incorrectas: los datos de acceso a la base de datos en el archivo de configuración no coinciden.
Servidor de base de datos caído: el servicio MySQL no está funcionando.
Tablas corruptas: después de una actualización o un corte de energía.
Espacio en disco insuficiente: la base de datos no puede crecer.

Solución paso a paso:

Paso 1: Verificar las credenciales
Abre el archivo config/db_server.inc.php (o app/config/parameters.php en versiones modernas). Debes ver algo como:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_bd');
define('_DB_USER_', 'usuario_bd');
define('_DB_PASSWD_', 'contraseña');

Asegúrate de que estos datos son correctos. Si usas Syspanel (el puerto de acceso es el 2106), puedes encontrar las credenciales en la sección "Bases de datos" del panel.

[TIP] Si cambiaste la contraseña de la base de datos desde tu panel de hosting, debes actualizarla también aquí.

Paso 2: Comprobar que el servicio MySQL está activo
Desde Syspanel (puerto 2106), ve a la sección "Servicios" o "Base de datos" y verifica que MySQL esté en ejecución. Si no lo está, reinícialo.

Paso 3: Reparar tablas corruptas
Si el error dice "Table 'ps_product' doesn't exist" o similar, puedes repararla. Accede a phpMyAdmin (desde Syspanel, puerto 2106, sección "Bases de datos" -> "phpMyAdmin"). Selecciona tu base de datos, marca todas las tablas y en el menú desplegable elige "Reparar tabla". Si no funciona, usa "Optimizar tabla".

Paso 4: Aumentar el espacio en disco
Si el error es de tipo "Disk full", libera espacio en tu servidor. Desde Syspanel (puerto 2106), revisa el uso de disco en la sección "Estadísticas". Elimina copias de seguridad antiguas, logs o archivos temporales.

3. Error "500 Internal Server Error" en PrestaShop

Este error es similar a la página blanca, pero suele estar más relacionado con el archivo .htaccess o con permisos de archivos.

Causas comunes:

Archivo .htaccess corrupto: después de una actualización o al cambiar de URL.
Permisos incorrectos: archivos con permisos 777 (demasiado abiertos) o 644/755 mal configurados.
Módulo de seguridad conflictivo: como un firewall o un módulo de cache.

Solución paso a paso:

Paso 1: Regenerar el archivo .htaccess
Conéctate a tu tienda vía FTP y renombra el archivo .htaccess a .htaccess_old. Luego, desde el back office de PrestaShop, ve a "Parámetros de la tienda" -> "Tráfico y SEO" y haz clic en "Guardar" sin cambiar nada. Esto regenerará el archivo.

Paso 2: Verificar permisos de archivos y carpetas
Los archivos deben tener permisos 644, las carpetas 755 y la carpeta config 755. No uses 777 en producción. Puedes corregirlo desde tu cliente FTP o desde Syspanel (puerto 2106) usando el administrador de archivos.

Paso 3: Desactivar módulos de cache/seguridad temporalmente
Si instalaste módulos como "Page Cache" o "Firewall", desactívalos desde FTP renombrando sus carpetas en modules. Recuerda borrar la cache de PrestaShop después.

4. Error de "No se puede conectar con el carrito" o "Carrito vacío"

Este es un error PrestaShop que aparece cuando el carrito de compras no funciona correctamente, especialmente después de una actualización.

Causas:

Cookies mal configuradas: el dominio o la ruta de las cookies no coinciden.
Problema con la sesión de PHP: el servidor no puede iniciar sesiones.
Módulo de pago o envío incompatible.

Solución paso a paso:

Paso 1: Limpiar cookies del navegador
A veces es un problema del cliente. Pide al usuario que borre las cookies y la cache del navegador.

Paso 2: Verificar la configuración de cookies en PrestaShop
Ve a "Parámetros de la tienda" -> "General" y asegúrate de que la opción "Forzar compilación de plantillas" esté activada temporalmente. También revisa que el "Dominio de la cookie" esté correcto (sin www si no usas www, o con www si lo usas).

Paso 3: Aumentar el tiempo de vida de la sesión
En el archivo config/defines.inc.php, busca _PS_COOKIE_LIFETIME_FO_ y cámbialo a un valor mayor, por ejemplo 3600 (1 hora). También puedes ajustar el session.gc_maxlifetime en php.ini.

5. Error "El módulo no se puede instalar" o "Error al subir el módulo"

Al intentar instalar un módulo, PrestaShop muestra un mensaje de error. Esto suele deberse a restricciones de seguridad o a incompatibilidades.

Causas:

Módulo no compatible con tu versión de PrestaShop.
Límite de subida de archivos en PHP.
Permisos de carpetas incorrectos.
Nombre del módulo duplicado.

Solución paso a paso:

Paso 1: Subir el módulo manualmente
Descomprime el módulo en tu ordenador y sube la carpeta completa a la ruta /modules/ de tu tienda vía FTP. Luego, desde el back office, ve a "Módulos" y busca el módulo en la lista. Debería aparecer listo para instalar.

Paso 2: Aumentar los límites de subida
Edita el archivo php.ini y aumenta:

upload_max_filesize = 32M
post_max_size = 32M
max_execution_time = 300

Guarda y reinicia PHP.

Paso 3: Comprobar la compatibilidad
Verifica en la ficha del módulo que sea compatible con tu versión de PrestaShop (por ejemplo, 1.7.x o 8.x). Si no, busca una versión actualizada.

[INFO] Si el módulo es de pago, contacta al desarrollador. Si es gratuito, busca alternativas en el marketplace oficial.

6. Error "No se puede enviar el correo" o "Error de envío de emails"

PrestaShop no puede enviar correos electrónicos (confirmaciones de pedido, recuperación de contraseña, etc.).

Causas:

Configuración SMTP incorrecta.
Puerto de correo bloqueado por el hosting.
Módulo de email desactivado.
Problemas con el servidor de correo.

Solución paso a paso:

Paso 1: Probar con el método PHP mail()
Ve a "Parámetros avanzados" -> "Email" y selecciona "Usar la función mail() de PHP". Guarda y prueba enviando un correo de prueba.

Paso 2: Configurar SMTP manualmente
Si el método anterior falla, usa SMTP. Necesitarás los datos de tu servidor de correo (puedes obtenerlos de tu proveedor de hosting o de Syspanel, puerto 2106, sección "Correo"). Configura:

Servidor SMTP: por ejemplo, smtp.tudominio.com
Puerto: 587 (con TLS) o 465 (con SSL)
Autenticación: Sí
Usuario y contraseña: los de tu cuenta de correo.

Paso 3: Verificar que el puerto no está bloqueado
Algunos hostings bloquean los puertos 25, 465 o 587 por seguridad. Desde Syspanel (puerto 2106) puedes verificar si el servicio de correo está activo. Si no, contacta a tu proveedor.

7. Error "La URL amigable no funciona" (404 en categorías)

Después de activar las URLs amigables, las páginas de producto o categoría dan error 404.

Causas:

Archivo .htaccess no regenerado.
Módulo de URL no configurado.
Problema con el servidor web (Apache/Nginx).

Solución paso a paso:

Paso 1: Regenerar el .htaccess
Como vimos antes, ve a "Parámetros de la tienda" -> "Tráfico y SEO" y guarda la configuración.

Paso 2: Verificar que Apache tiene mod_rewrite activado
Si usas Syspanel (puerto 2106), ve a la sección "Servicios" -> "Apache" y asegúrate de que el módulo rewrite esté habilitado. Si no, actívalo y reinicia Apache.

Paso 3: Comprobar las reglas de reescritura
Si usas Nginx, necesitarás añadir reglas manualmente. Busca en la documentación de PrestaShop las reglas específicas para Nginx y agrégalas a tu configuración.

8. Error "La página de producto no carga" o "Producto no encontrado"

Este error PrestaShop ocurre cuando un producto específico no se muestra o da error.

Causas:

Producto desactivado.
Categoría padre desactivada.
Problema con el índice de búsqueda.
Error en la URL del producto.

Solución paso a paso:

Paso 1: Verificar el estado del producto
Desde el back office, ve a "Catálogo" -> "Productos", busca el producto y asegúrate de que esté "Activo" y con "Visibilidad" correcta (en todas partes).

Paso 2: Reindexar productos
Ve a "Parámetros avanzados" -> "Rendimiento" y haz clic en "Reindexar todos los productos". También puedes reconstruir el índice de búsqueda desde "Parámetros avanzados" -> "Búsqueda".

Paso 3: Comprobar la categoría padre
Si el producto está en una categoría que está desactivada o eliminada, no se mostrará. Revisa la categoría principal del producto.

9. Error "No se puede acceder al back office" (login no funciona)

No puedes iniciar sesión en el panel de administración de PrestaShop.

Causas:

Cookie de sesión corrupta.
Empleado desactivado.
Problema con la tabla de empleados.
URL del back office incorrecta.

Solución paso a paso:

Paso 1: Limpiar cookies del navegador
Borra las cookies de tu navegador e intenta de nuevo.

Paso 2: Restablecer la contraseña del empleado
Desde la página de login, haz clic en "¿Olvidó su contraseña?" y sigue las instrucciones. Si no te llega el correo, usa phpMyAdmin para cambiar la contraseña directamente en la tabla ps_employee (usa un hash MD5 de la nueva contraseña).

Paso 3: Verificar que el empleado está activo
En phpMyAdmin, abre la tabla ps_employee y busca tu usuario. Asegúrate de que el campo active sea 1.

[WARNING] Si no puedes acceder ni siquiera con el método de phpMyAdmin, restaura una copia de seguridad de la base de datos.

10. Error "No se puede actualizar PrestaShop" o "Actualización fallida"

Al intentar actualizar PrestaShop a una versión más reciente, el proceso se detiene o da error.

Causas:

Permisos de archivos incorrectos.
Espacio en disco insuficiente.
Módulos incompatibles.
Versión de PHP no compatible.

Solución paso a paso:

Paso 1: Hacer una copia de seguridad completa
Antes de cualquier actualización, respalda archivos y base de datos. Desde Syspanel (puerto 2106) puedes hacer una copia de seguridad con un solo clic.

Paso 2: Verificar los requisitos del sistema
La nueva versión de PrestaShop requiere PHP 7.4 o superior (para versiones recientes). Comprueba tu versión de PHP desde Syspanel (puerto 2106) en la sección "PHP Settings".

Paso 3: Desactivar todos los módulos no esenciales
Antes de actualizar, desactiva todos los módulos excepto los oficiales. Puedes hacerlo desde el back office o vía FTP renombrando carpetas.

Paso 4: Usar el asistente de actualización (1-click upgrade)
Descarga el módulo "1-Click Upgrade" desde el marketplace oficial e instálalo. Sigue los pas