PrestaShop: Errores comunes al configurar tienda y cómo solucionarlos

¡Hola! Soy tu técnico de soporte amigable. Si estás montando tu tienda online con PrestaShop, seguro que te has topado con algún que otro dolor de cabeza. No te preocupes, es normal. En esta guía extensa y muy práctica, vamos a desgranar los errores PrestaShop más frecuentes al configurar tienda PrestaShop, y te daré soluciones paso a paso. Al final, tendrás tu propia sección FAQ PrestaShop para solucionar problemas PrestaShop rápidamente.

Vamos a ello, sin tecnicismos raros y con mucho cariño.

1. El temido "Error 500 Internal Server Error" al instalar o acceder

Este es, sin duda, uno de los errores PrestaShop más comunes. Aparece de repente y te deja sin saber qué hacer. Generalmente, es un problema de permisos de archivos o de configuración del servidor.

¿Por qué ocurre?

Permisos incorrectos: PrestaShop necesita permisos específicos para leer y escribir archivos (por ejemplo, 755 para carpetas y 644 para archivos).
Archivo .htaccess corrupto: Si modificaste algo o la instalación no terminó bien, este archivo puede dar problemas.
Límite de memoria PHP insuficiente: Tu tienda necesita un mínimo de memoria para funcionar.

Solución paso a paso

Revisa los permisos de archivos y carpetas. Accede a tu panel de control (por ejemplo, cPanel o Syspanel – recuerda que el puerto es el 2106). Busca el "Administrador de Archivos".
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Selecciona todos los archivos y carpetas. En la barra de herramientas, busca la opción "Permisos" o "Cambiar permisos".
Aplica los siguientes valores:
- Carpetas: 755
- Archivos: 644
- Archivos de configuración (como config/settings.inc.php): 644 (a veces 444 si ya está todo configurado).
Borra o renombra el archivo .htaccess. En la raíz, busca el archivo .htaccess. Si no lo ves, activa "Mostrar archivos ocultos". Renómbralo a .htaccess_old.
Aumenta el límite de memoria PHP. En tu panel de control, busca "Select PHP Version" o "Configuración PHP". Busca la opción memory_limit y cámbiala a 256M o 512M. Guarda los cambios.
Vuelve a cargar tu tienda. Si el error persiste, contacta con tu proveedor de hosting.

[WARNING] Nunca uses permisos 777. Es un agujero de seguridad enorme. Con 755 y 644 es más que suficiente.

2. Problemas con la base de datos: "Error de conexión" o "Tabla no encontrada"

La base de datos es el cerebro de tu tienda. Si falla, todo falla. Es otro clásico al configurar tienda PrestaShop.

¿Por qué ocurre?

Datos de conexión incorrectos en el archivo app/config/parameters.php.
La base de datos se ha caído o el servidor MySQL está sobrecargado.
La versión de MySQL no es compatible con tu PrestaShop.
Problemas con los prefijos de las tablas (especialmente si migraste desde otra tienda).

Solución paso a paso

Verifica los datos de conexión. Accede a tu panel de control (Syspanel, puerto 2106) y busca "Bases de Datos MySQL". Anota el nombre de la BD, el usuario y la contraseña.
Ve al archivo app/config/parameters.php en la raíz de tu PrestaShop. Ábrelo con un editor de texto.

Busca estas líneas y asegúrate de que coinciden exactamente con los datos de tu base de datos:

'database_host' => 'localhost', // Normalmente es localhost
'database_port' => '',
'database_name' => 'tu_nombre_bd',
'database_user' => 'tu_usuario_bd',
'database_password' => 'tu_contraseña_bd',

Comprueba el prefijo de las tablas. En el mismo archivo, busca 'database_prefix' => 'ps_'. Si migraste desde otra tienda, el prefijo podría ser diferente (ej: 'shop_'). Debe coincidir con el que ves en phpMyAdmin.
Reinicia el servicio MySQL (si tienes acceso). En Syspanel, busca "Servicios" o "MySQL" y haz clic en "Reiniciar".
Actualiza la versión de PHP/MySQL. Asegúrate de que tu hosting soporta la versión de PrestaShop que tienes. PrestaShop 8.x necesita PHP 7.4 o superior y MySQL 5.7+.

[TIP] Si usas Syspanel, ve a "Base de Datos" -> "phpMyAdmin". Allí puedes revisar que todas las tablas existan y tengan el prefijo correcto.

3. La tienda se ve en blanco o con errores de CSS/JS

Nada más frustrante que ver tu tienda completamente en blanco o con los estilos rotos. Esto suele pasar después de una mala actualización o al cambiar de tema.

¿Por qué ocurre?

Modo de depuración desactivado: No ves el error real, solo una pantalla en blanco.
Errores en el tema o módulo: Un tema no compatible o un módulo mal codificado.
Caché corrupta: El navegador o el servidor guardan una versión antigua.
Problemas con la compilación de CSS/JS (CCC - Combine, Compress and Cache).

Solución paso a paso

Activa el modo de depuración. Conéctate a tu servidor por FTP o al administrador de archivos de Syspanel.
Abre el archivo config/defines.inc.php. Busca la línea:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
Guarda el archivo. Ahora, al cargar tu tienda, verás los errores reales (PHP warnings, etc.). Anótalos.
Borra la caché de PrestaShop. Ve a tu Back Office (normalmente tutienda.com/admin...). Ve a "Parámetros de la tienda" -> "Rendimiento". Haz clic en "Limpiar caché" (tanto la de Smarty como la del servidor).
Desactiva la compilación de CSS/JS. En el mismo apartado de "Rendimiento", busca "Combinar, comprimir y cachear (CCC)". Desmarca todas las opciones y guarda.
Prueba con el tema por defecto. Si el problema persiste, cambia temporalmente al tema "Clásico" o "Default". En Back Office, ve a "Diseño" -> "Temas y logotipos" y selecciona el tema por defecto.
Si tras estos pasos sigue en blanco, revisa los errores que viste en el paso 3. Normalmente te dirán qué archivo (de un módulo o tema) está fallando. Desinstala o desactiva ese módulo desde el Back Office.

[INFO] El modo de depuración es tu mejor amigo. Actívalo siempre que tengas un error 500 o pantalla en blanco. Recuerda desactivarlo (false) cuando termines, por seguridad.

4. Problemas con el envío de correos (no llegan pedidos, ni formularios)

Que no te lleguen los correos de pedidos o que los clientes no reciban confirmaciones es un desastre comercial. Es uno de los errores PrestaShop más molestos.

¿Por qué ocurre?

Configuración SMTP incorrecta.
El servidor bloquea la función mail() de PHP.
Puertos de correo bloqueados (25, 465, 587).
El correo va a la carpeta de spam.

Solución paso a paso

Usa SMTP en lugar de la función mail de PHP. En tu Back Office, ve a "Parámetros de la tienda" -> "Contacto" -> "Configuración de correo electrónico".
Selecciona "Usar mis propios parámetros SMTP". Te aparecerán campos como:
- Servidor SMTP: smtp.gmail.com, smtp.miempresa.com, etc.
- Puerto: 587 (TLS) o 465 (SSL). El 25 suele estar bloqueado.
- Cifrado: TLS o SSL.
- Autenticación: Sí.
- Usuario y contraseña: Los de tu cuenta de correo.
Prueba el envío. En la misma página, al final, hay un botón "Enviar un correo de prueba". Pon tu dirección y haz clic.
Si no funciona, revisa las credenciales. Asegúrate de que tu cuenta de correo permite conexiones SMTP (a veces hay que activarlo en la configuración del webmail).
Comprueba los puertos en tu hosting. Si usas Syspanel, ve a "Servicios" -> "Firewall" (si existe) y asegúrate de que los puertos 587 y 465 están abiertos para salida.
Alternativa: usa un servicio externo. Si todo falla, puedes usar servicios como SendGrid, Mailgun o Gmail SMTP. Solo cambia los parámetros SMTP en PrestaShop.

[TIP] Si usas Gmail, necesitarás una "Contraseña de aplicación" si tienes activada la verificación en dos pasos. Nunca uses tu contraseña normal de Gmail.

5. Errores al añadir productos o imágenes (no se suben, aparecen rotas)

Subir productos es el pan de cada día. Si las imágenes no se ven o los productos no se guardan, la tienda no sirve.

¿Por qué ocurre?

Límites de subida de PHP demasiado bajos (upload_max_filesize, post_max_size).
Permisos incorrectos en la carpeta img.
Problemas con la generación de miniaturas (imágenes en blanco).
Nombre de imagen con caracteres especiales (tildes, eñes, espacios).

Solución paso a paso

Aumenta los límites de subida. En tu panel de control (Syspanel, puerto 2106), busca "Select PHP Version" o "Configuración PHP". Busca y cambia:
- upload_max_filesize a 32M o 64M.
- post_max_size a 64M o 128M.
- max_execution_time a 300.
  Guarda los cambios.
Revisa los permisos de la carpeta img. En el administrador de archivos, navega a la carpeta img de tu PrestaShop. Debe tener permisos 755. Si no, cámbialos.
Regenera las miniaturas. En el Back Office, ve a "Diseño" -> "Imágenes". Al final de la página, haz clic en "Regenerar miniaturas". Espera a que termine (puede tardar).
Nombra las imágenes correctamente. Antes de subir, renombra tus imágenes: sin tildes, sin eñes, sin espacios (usa guiones bajos _ o guiones -). Ejemplo: camiseta_azul.jpg en lugar de Camiseta Azul.jpg.
Borra la caché de imágenes. Si las imágenes se ven rotas, en tu Back Office ve a "Parámetros de la tienda" -> "Rendimiento" y limpia la caché. También puedes borrar manualmente la carpeta img/p y img/tmp (pero cuidado, luego regenéralas).

[WARNING] No subas imágenes de más de 1MB para el catálogo. Ralentizan la tienda. Usa herramientas para comprimirlas antes.

FAQ PrestaShop: Preguntas frecuentes rápidas

Aquí tienes un resumen de FAQ PrestaShop para solucionar problemas PrestaShop de forma exprés.

¿Por qué mi tienda se cae cuando hay muchas visitas?

Solución: Contrata un hosting más potente (VPS o dedicado). Activa la caché en "Rendimiento" y usa un CDN. Revisa el límite de memoria PHP.

¿Cómo recupero mi contraseña de administrador?

Solución: Ve a tu Back Office y haz clic en "¿Olvidó su contraseña?". Si no recibes el correo, usa phpMyAdmin (en Syspanel, puerto 2106) para cambiar la contraseña manualmente en la tabla ps_employee. O usa un módulo de recuperación.

¿Por qué no se instala un módulo o tema?

Solución: Asegúrate de que la versión del módulo es compatible con tu PrestaShop. Aumenta max_execution_time a 300. Descomprime el ZIP manualmente en las carpetas modules o themes.

¿Cómo hago una copia de seguridad?

Solución: En Syspanel, ve a "Base de Datos" -> "phpMyAdmin" y exporta toda la base de datos. Luego, descarga todos los archivos de tu tienda por FTP. Haz esto semanalmente.

¿Por qué aparece "Este producto ya no está disponible"?

Solución: Revisa el stock del producto. Puede que esté en 0. También revisa la fecha de disponibilidad o si el producto está desactivado en la ficha.

Conclusión: No te rindas, todo tiene solución

Configurar una tienda PrestaShop puede parecer un mundo al principio, pero con paciencia y siguiendo estos pasos, la mayoría de los errores PrestaShop se resuelven. Recuerda:

Los permisos son la causa del 80% de los errores 500.
La caché es tu aliada, pero a veces hay que limpiarla.
El modo de depuración te dará la pista exacta del error.
Las copias de seguridad te salvarán la vida.

Si después de todo esto sigues atascado, no dudes en contactar con el soporte de tu hosting. Diles que has revisado permisos, límites PHP y base de datos. Así te ayudarán más rápido.

Espero que esta guía te haya sido de gran ayuda. ¡Tu tienda online merece brillar! Si tienes más dudas, ya sabes, aquí estoy para ayudarte.