Errores comunes en PrestaShop: soluciones y FAQ

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

PrestaShop es una de las plataformas de comercio electrónico más potentes y flexibles, pero como cualquier sistema complejo, puede presentar errores. Muchos de estos problemas no son culpa tuya, sino que están relacionados con el entorno de hosting, la configuración del servidor o pequeñas incompatibilidades. No te preocupes: la mayoría tienen solución y no requieres ser un experto en programación.

En esta guía extensa, vamos a recorrer los errores más comunes que aparecen en PrestaShop, cómo identificarlos y, lo más importante, cómo solucionarlos paso a paso. Usaremos un tono muy cercano, para que incluso si es tu primera vez con una tienda online, puedas seguir las instrucciones sin problema.

[INFO] Si en algún momento necesitas acceder al panel de control de tu servidor (HestiaCP, que llamaremos Syspanel), recuerda que la dirección suele ser tu-dominio.com:2106 y que allí podrás gestionar bases de datos, archivos y dominios.

## Error 500 Internal Server Error en PrestaShop

Este es, sin duda, uno de los errores PrestaShop más temidos. Aparece una pantalla en blanco con el texto "500 Internal Server Error" o simplemente la página no carga. Las causas pueden ser varias, pero las más comunes son:

Un archivo .htaccess corrupto o mal configurado.
Un módulo o tema incompatible.
Límites de memoria del servidor muy bajos.
Permisos de archivos incorrectos.

### ¿Cómo solucionarlo?

Accede a tu servidor por FTP o al administrador de archivos de Syspanel.
- Si usas Syspanel, ve a la sección "Archivos" y navega hasta la carpeta public_html (o la carpeta donde tengas instalado PrestaShop).
Renombra el archivo .htaccess.
- Busca el archivo llamado .htaccess (puede estar oculto, activa "Mostrar archivos ocultos").
- Cámbiale el nombre a algo como .htaccess_old. Esto desactivará las reglas de reescritura temporalmente.
- Vuelve a cargar tu tienda. Si el error 500 desaparece, el problema estaba en el .htaccess. Puedes regenerarlo desde el panel de administración de PrestaShop (Parámetros de la tienda > Tráfico y SEO > SEO y URLs > botón "Guardar" sin cambiar nada).
Aumenta el límite de memoria PHP.
- Desde Syspanel, busca la opción "PHP" o "Configuración PHP".
- Busca el parámetro memory_limit y cámbialo a 256M o incluso 512M.
- Guarda los cambios y recarga la tienda.
Desactiva módulos y temas desde la base de datos (si no puedes acceder al panel).
- Ve a phpMyAdmin desde Syspanel (sección "Bases de datos").
- Selecciona la base de datos de tu PrestaShop.
- Busca la tabla ps_configuration (el prefijo ps_ puede variar).
- Localiza la fila donde name sea PS_MODULES_DISABLED y bórrala (o cámbiala a 1). Esto forzará a que todos los módulos se desactiven al cargar la tienda, permitiéndote acceder al panel.

[WARNING] Si después de estos pasos el error persiste, contacta con tu proveedor de hosting. Podría ser un problema de configuración del servidor que ellos deben resolver.

## Error de conexión a la base de datos (Error establishing a database connection)

Este error suele aparecer cuando PrestaShop no puede comunicarse con la base de datos MySQL. Las causas típicas son:

Datos de conexión incorrectos en el archivo settings.inc.php.
La base de datos ha sido eliminada o está corrupta.
El servidor de base de datos está caído o sobrecargado.

### Pasos para solucionarlo

Verifica los datos de conexión.
- Accede por FTP o al administrador de archivos de Syspanel.
- Navega hasta config/settings.inc.php.
- Ábrelo con un editor de texto (Bloc de notas, Notepad++, etc.).
- Busca estas líneas y comprueba que coincidan con los datos de tu base de datos:
```
define('_DB_SERVER_', 'localhost'); // o la IP del servidor MySQL
define('_DB_NAME_', 'nombre_de_tu_bd');
define('_DB_USER_', 'usuario_de_tu_bd');
define('_DB_PASSWD_', 'contraseña_de_tu_bd');
```
- Si no estás seguro de los datos, puedes obtenerlos desde Syspanel: ve a "Bases de datos" y ahí verás el nombre, usuario y contraseña.
Revisa que la base de datos exista y tenga tablas.
- Desde phpMyAdmin (Syspanel > Bases de datos), selecciona tu base de datos.
- En la izquierda deberías ver una lista de tablas (como ps_product, ps_customer, etc.). Si no ves ninguna, la base de datos está vacía. En ese caso, necesitarás restaurar una copia de seguridad.
Prueba la conexión manualmente.
- Crea un archivo llamado test.php en la raíz de tu tienda con este contenido:
```
<?php
$conexion = mysqli_connect('localhost', 'usuario', 'contraseña', 'nombre_bd');
if (!$conexion) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo 'Conectado correctamente';
mysqli_close($conexion);
?>
```
- Accede a tudominio.com/test.php. Si ves "Conectado correctamente", el problema está en el archivo settings.inc.php. Si ves otro error, el problema es del servidor.

[TIP] Si todo lo anterior falla, contacta a tu hosting. A veces el servidor MySQL se reinicia o hay un corte temporal.

## Pantalla blanca (White Screen of Death) en PrestaShop

La famosa "pantalla blanca" es otro de los errores PrestaShop más frustrantes. No ves nada, ni siquiera un mensaje de error. Generalmente se debe a un error PHP fatal que no se muestra por estar la visualización de errores desactivada.

### Solución paso a paso

Activa la visualización de errores.
- Edita el archivo config/defines.inc.php (o config/config.inc.php en versiones antiguas).
- Busca la línea:
```
define('_PS_MODE_DEV_', false);
```
- Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
- Guarda el archivo y recarga la tienda. Ahora deberías ver un mensaje de error específico (por ejemplo, "Fatal error: Call to undefined function...").
Identifica el error y actúa.
- Si el error menciona un módulo, desactívalo desde la base de datos (como explicamos en el error 500).
- Si menciona un tema, cambia temporalmente al tema predeterminado (por ejemplo, classic) desde la base de datos (tabla ps_configuration, campo PS_THEME_NAME).
Aumenta el límite de memoria (otra vez).
- Muchas pantallas blancas se deben a falta de memoria. Asegúrate de tener al menos 256M.

[WARNING] No olvides volver a poner _PS_MODE_DEV_ en false después de solucionar el error, o tu tienda mostrará información sensible a los visitantes.

## Error al instalar un módulo o tema: "No se puede cargar el archivo"

Este error suele aparecer cuando intentas subir un módulo o tema y PrestaShop no lo acepta. Las causas más comunes son:

El archivo ZIP está corrupto o no tiene la estructura correcta.
El tamaño del archivo supera el límite permitido por el servidor.
Falta permiso de escritura en la carpeta de módulos o temas.

### ¿Cómo arreglarlo?

Verifica el límite de subida de archivos.
- Desde Syspanel, ve a "Configuración PHP" y busca upload_max_filesize y post_max_size. Ambos deberían ser al menos 64M o más.
- Si no puedes cambiarlos, contacta a tu hosting.
Aumenta el tiempo de ejecución.
- Busca max_execution_time y cámbialo a 300 (5 minutos).
Sube el módulo manualmente.
- Descomprime el ZIP en tu ordenador.
- Sube la carpeta del módulo (por ejemplo, micodigo) a la carpeta modules/ de tu PrestaShop mediante FTP.
- Ve al panel de administración, a "Módulos" y debería aparecer listo para instalar.
Revisa los permisos de las carpetas.
- Las carpetas modules/ y themes/ deben tener permisos 755 (lectura, escritura y ejecución para el usuario, y solo lectura para los demás). Si tienes dudas, desde Syspanel puedes cambiar permisos fácilmente.

[TIP] Siempre descarga módulos y temas de fuentes oficiales (PrestaShop Addons o desarrolladores de confianza) para evitar problemas de compatibilidad.

## Error de caché: "La página no se actualiza"

A veces haces cambios en tu tienda (precios, productos, texto) y no se ven reflejados. Esto es por la caché de PrestaShop.

### Solución rápida

Limpia la caché desde el panel de administración.
- Ve a "Parámetros de la tienda" > "Rendimiento".
- Haz clic en "Limpiar la caché" (también puedes borrar las opciones de "Caché de Smarty" y "Caché de combinación").
Borra la carpeta de caché manualmente.
- Si no tienes acceso al panel, conecta por FTP y borra todo el contenido de la carpeta var/cache/ (en PrestaShop 1.7) o cache/ (en versiones anteriores).
Desactiva la caché temporalmente.
- En "Rendimiento", cambia "Caché" a "No" y guarda. Esto es útil para pruebas, pero no lo dejes así en producción porque ralentizará tu tienda.

[INFO] Si tienes un CDN o caché de servidor (como Varnish), también deberás purgarlo desde Syspanel o el panel de tu hosting.

## Error de URL amigable: "Página no encontrada" (404)

Después de activar las URLs amigables, algunas páginas dan error 404. Esto suele pasar porque el archivo .htaccess no se ha regenerado correctamente.

### Solución

Regenera el .htaccess.
- Ve a "Parámetros de la tienda" > "Tráfico y SEO" > "SEO y URLs".
- Sin cambiar nada, haz clic en "Guardar". Esto regenera el archivo automáticamente.
Verifica que el módulo de reescritura esté activo en el servidor.
- Desde Syspanel, en la sección "PHP" o "Apache", asegúrate de que mod_rewrite esté habilitado. Si no, pide a tu hosting que lo activen.
Comprueba la configuración de la URL de la tienda.
- En la misma sección, asegúrate de que "URL de la tienda" sea correcta (sin barras al final, por ejemplo https://tudominio.com).

## Preguntas Frecuentes (FAQ) sobre errores en PrestaShop

Aquí tienes respuestas a las dudas más comunes que recibimos en soporte.

### ¿Por qué mi PrestaShop se vuelve lento?

Causa común: Módulos mal optimizados, caché desactivada, servidor con recursos insuficientes.
Solución: Activa la caché, desactiva módulos que no uses, contrata un plan de hosting con más RAM y CPU.

### ¿Cómo recupero mi tienda si no tengo copia de seguridad?

Primero: No toques nada más. Contacta a tu hosting, a veces ellos tienen backups automáticos.
Segundo: Si no, puedes intentar restaurar desde la carpeta modules/ o themes/ si tienes acceso a los archivos, pero la base de datos es irrecuperable sin backup.

### ¿Qué hago si veo "Fatal error: Allowed memory size of X bytes exhausted"?

Aumenta el memory_limit en Syspanel (Configuración PHP) a 256M o 512M. Si no puedes, pide ayuda a tu hosting.

### ¿Puedo cambiar de hosting sin perder datos?

Sí, pero es un proceso delicado. Necesitas exportar la base de datos (phpMyAdmin), copiar todos los archivos por FTP y luego importar en el nuevo hosting. Si no te sientes seguro, contrata un servicio de migración.

### ¿Por qué no puedo acceder al panel de administración?

Prueba a limpiar la caché del navegador o usar otro navegador. Si el error persiste, puede ser un problema de sesión. Borra la carpeta var/cache/ y prueba de nuevo.

## Consejos finales para evitar errores PrestaShop

Mantén todo actualizado: PrestaShop, módulos y temas. Las actualizaciones corrigen errores y vulnerabilidades.
Haz copias de seguridad semanales: Desde Syspanel puedes programar backups automáticos de tu base de datos y archivos.
Elige un buen hosting: Un servidor optimizado para PrestaShop (con PHP 8.x, MySQL 8 y suficiente RAM) evitará el 80% de los problemas hosting PrestaShop.
No instales módulos de dudosa procedencia: Pueden contener código malicioso o ser incompatibles.

Recuerda que en el soporte técnico estamos para ayudarte. Si después de seguir esta guía sigues teniendo errores, no dudes en contactarnos. ¡Tu tienda online volverá a funcionar en poco tiempo!