Problemas comunes en PrestaShop: soluciones y guía de errores

Si estás leyendo esto, probablemente te hayas topado con algún mensaje de error en tu tienda 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 completa, vamos a recorrer los errores más frecuentes en PrestaShop, entender por qué ocurren y, lo más importante, cómo solucionarlos paso a paso.

Piensa en este artículo como tu mapa para resolver problemas. No necesitas ser un experto en programación; solo sigue las indicaciones y, si algo se complica, recuerda que siempre puedes pedir PrestaShop ayuda a tu proveedor de hosting o en los foros oficiales. Vamos a empezar.

El temido "Error 500" o "Error interno del servidor"

Este es, sin duda, uno de los errores PrestaShop más frustrantes porque no da mucha información. Aparece de repente y te deja con la tienda caída. La causa suele ser un archivo corrupto, un módulo incompatible o un problema de permisos.

¿Qué hacer primero?

Activa el modo debug de PrestaShop. Esto te mostrará el error real detrás del 500. Para ello, edita el archivo config/defines.inc.php en la raíz de tu tienda.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo. Ahora, al recargar la página, verás un mensaje más descriptivo (por ejemplo, "Class not found" o "Allowed memory size exhausted").

Soluciones comunes

Aumentar la memoria PHP: Si el error dice algo de "memory size", debes aumentar el límite. Accede a tu panel de control (por ejemplo, Syspanel en el puerto 2106) y busca la sección de "PHP Settings" o "Administrador de PHP". Cambia el valor de memory_limit a 256M o 512M.
Desactivar un módulo conflictivo: Si el error apareció tras instalar un módulo, renombra la carpeta del módulo en /modules/nombre_del_modulo a /modules/nombre_del_modulo_old. Esto lo desactivará.
Verificar permisos de archivos: Los archivos y carpetas deben tener permisos 755 (para carpetas) y 644 (para archivos). Puedes hacerlo desde un cliente FTP o desde el gestor de archivos de Syspanel.

[WARNING] No olvides volver a poner define('_PS_MODE_DEV_', false); una vez hayas solucionado el error. Dejarlo activo en producción muestra información sensible a los visitantes.

El clásico "Error de conexión a la base de datos"

Este error aparece cuando PrestaShop no puede comunicarse con MySQL. Verás un mensaje como "Cannot connect to database" o "Error establishing a database connection". Es uno de los errores PrestaShop que más asusta a los principiantes, pero tiene solución.

Pasos para solucionarlo

Revisa el archivo de configuración: Abre el archivo app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en versiones antiguas). Busca estas líneas:
- 'database_host' => 'localhost' (o la IP de tu servidor).
- 'database_name' => 'nombre_de_tu_bd'
- 'database_user' => 'usuario_de_tu_bd'
- 'database_password' => 'contraseña'
Verifica los datos: Asegúrate de que coincidan exactamente con los que te proporcionó tu hosting. Un error muy común es cambiar la contraseña de la base de datos y olvidar actualizar este archivo.
Comprueba el servidor MySQL: Desde tu panel de control (como Syspanel, puerto 2106), ve a "Base de datos" y verifica que el servicio MySQL esté corriendo. Si está detenido, inícialo.
Prueba la conexión manualmente: Usa una herramienta como phpMyAdmin (también accesible desde Syspanel) para conectarte con esos mismos datos. Si no funciona, el problema está en las credenciales o en el servidor.

[INFO] Si cambiaste recientemente de hosting, asegúrate de haber importado correctamente la base de datos y de que las rutas en parameters.php apunten al nuevo servidor.

Pantalla en blanco (White Screen of Death)

La temida pantalla en blanco es otro de los errores PrestaShop más habituales. No hay mensaje, solo una página vacía. Las causas son similares al error 500, pero con un enfoque distinto.

Diagnóstico y solución

Activa el modo debug (como explicamos antes) para ver el error real.
Verifica la memoria PHP: Si no hay mensaje de error, sube el memory_limit a 256M como mínimo.
Revisa los logs del servidor: Accede a Syspanel (puerto 2106) y busca la sección "Registros" o "Logs". Allí suele haber un archivo llamado error.log o php_error.log. Busca la línea que coincida con la hora del error.
Desactiva todos los módulos no esenciales: Si no puedes acceder al panel de administración, renombra la carpeta /modules a /modules_backup y crea una nueva carpeta /modules vacía. Luego, ve añadiendo módulos de uno en uno hasta encontrar el culpable.
Actualiza el tema: Si el error empezó tras cambiar de tema, prueba a volver al tema predeterminado (por ejemplo, "classic"). Puedes hacerlo directamente editando la tabla ps_shop_url en la base de datos (con phpMyAdmin) o editando el archivo config/themes.inc.php.

Error "El archivo no se ha podido subir" o problemas con imágenes

Si al subir imágenes de productos recibes un error, suele ser por límites de PHP o por permisos. Es un problema recurrente en PrestaShop tutorial de resolución de problemas.

Pasos para arreglarlo

Aumenta los límites de subida: En Syspanel (puerto 2106), busca la configuración de PHP y cambia estos valores:
- upload_max_filesize: 32M (o más).
- post_max_size: 32M (o más).
- max_execution_time: 300 (segundos).
Verifica la carpeta de imágenes: La carpeta /img y sus subcarpetas deben tener permisos 755. Si usas FTP, asegúrate de que el usuario del servidor web (www-data, por ejemplo) sea el propietario.
Regenera las miniaturas: Si las imágenes se suben pero no se ven, ve al panel de administración de PrestaShop > "Parámetros de la tienda" > "Imágenes" y haz clic en "Regenerar miniaturas". Esto puede tardar unos minutos.

Error de compatibilidad de PHP

PrestaShop es muy sensible a la versión de PHP. Si ves errores como "Deprecated function" o "Call to undefined function", probablemente tu PHP no es el adecuado.

Cómo solucionarlo

Verifica la versión actual: Desde Syspanel (puerto 2106), ve a "PHP Settings" y mira qué versión tienes.
Cambia la versión de PHP: PrestaShop 1.6 funciona mejor con PHP 5.6 o 7.0. PrestaShop 1.7 necesita PHP 7.1 o superior (idealmente 7.4 o 8.0). Syspanel te permite cambiar la versión con un solo clic.
Prueba la tienda: Después del cambio, recarga la página. Si el error persiste, puede que algún módulo no sea compatible con esa versión. En ese caso, actualiza el módulo o busca una alternativa.

[TIP] Si estás migrando de PHP 5.6 a 7.4, haz una copia de seguridad completa antes. Algunos módulos antiguos pueden romperse.

Error "No se puede escribir en la carpeta cache"

Este es un error típico de permisos. PrestaShop necesita escribir en ciertas carpetas para funcionar correctamente.

Solución rápida

Borra la carpeta cache manualmente: Conecta por FTP o usa el gestor de archivos de Syspanel y elimina todo el contenido de la carpeta /var/cache (o /cache en versiones antiguas). No borres la carpeta en sí, solo su interior.
Reasigna permisos: Asegúrate de que las carpetas /cache, /log, /img, /upload y /download tengan permisos 755. Si usas Syspanel, puedes hacerlo desde el administrador de archivos seleccionando la carpeta y cambiando los permisos.
Desactiva la caché temporalmente: Si el error persiste, desde el back office de PrestaShop, ve a "Parámetros avanzados" > "Rendimiento" y desactiva todas las opciones de caché. Luego, vuelve a activarlas una por una.

Problemas con el carrito de compra (no se añaden productos)

Este error suele estar relacionado con las cookies o con la configuración de SSL. Es muy frustrante para el usuario, pero fácil de arreglar.

Pasos para solucionarlo

Limpia las cookies de tu navegador: A veces el problema es local. Pide al cliente que borre las cookies o que use una ventana de incógnito.
Verifica la configuración de SSL: Ve a "Parámetros de la tienda" > "Tráfico y SEO" y asegúrate de que la opción "Activar SSL" esté en "Sí" y que la URL de tu tienda comience con https://.
Revisa los módulos de pago: Desactiva temporalmente los módulos de pago y envio. Si el carrito funciona sin ellos, reactívalos uno a uno para encontrar el conflictivo.
Aumenta la memoria de sesión: Si el problema ocurre con muchos productos en el carrito, aumenta session.gc_maxlifetime en la configuración de PHP (desde Syspanel) a 14400 (4 horas).

Errores de actualización de PrestaShop

Actualizar PrestaShop puede ser un dolor de cabeza. Los errores más comunes son "El archivo no se encuentra" o "Error al migrar la base de datos".

Guía para una actualización exitosa

Haz una copia de seguridad completa: Antes de nada, copia todos los archivos por FTP y exporta la base de datos desde phpMyAdmin (en Syspanel, puerto 2106).
Usa el módulo 1-Click Upgrade: Descarga la última versión de este módulo oficial. No intentes actualizar manualmente si no sabes lo que haces.
Desactiva todos los módulos no esenciales: Durante la actualización, solo deben estar activos los módulos oficiales de PrestaShop.
Sigue los pasos en orden: El módulo te guiará. Si aparece un error, anótalo y busca en los foros. Muchas veces es por un módulo incompatible.
Si falla, restaura la copia: No te desesperes. Restaura los archivos y la base de datos desde tu copia de seguridad. Luego, intenta la actualización de nuevo, pero esta vez desactivando más módulos.

[WARNING] Nunca actualices PrestaShop en un servidor de producción sin antes probarlo en un entorno de pruebas (staging). Muchos proveedores de hosting, como los que usan Syspanel, ofrecen esta opción.

Preguntas Frecuentes (FAQ)

¿Por qué mi PrestaShop va lento?

La lentitud puede deberse a un hosting compartido con muchos recursos, a módulos mal optimizados o a una base de datos sin limpiar. Activa la caché de PrestaShop, optimiza las imágenes y considera contratar un hosting con mejores prestaciones. Desde Syspanel puedes monitorizar el uso de CPU y RAM.

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

Si no puedes acceder al back office, usa la función "¿Olvidó su contraseña?" en la pantalla de login. Si no recibes el email, pide a tu hosting que verifique el envío de correo. Como último recurso, puedes cambiar la contraseña directamente en la base de datos (tabla ps_employee) usando phpMyAdmin.

¿Qué hago si un módulo de pago no funciona?

Primero, verifica que el módulo esté actualizado. Luego, comprueba que las claves API de tu pasarela de pago (PayPal, Stripe, etc.) sean correctas. Si el error persiste, desactiva otros módulos de pago para descartar conflictos. Muchos PrestaShop tutorial recomiendan probar con el módulo de pago por defecto.

¿Cómo soluciono el error "No se puede conectar al servicio de traducción"?

Este error suele aparecer por problemas de conexión con los servidores de PrestaShop. Asegúrate de que tu servidor pueda hacer peticiones externas (curl, allow_url_fopen). Si tu hosting bloquea estas conexiones, contacta con soporte. En Syspanel, puedes revisar la configuración de PHP para habilitar estas funciones.

Conclusión y recursos adicionales

Como has visto, la mayoría de los errores PrestaShop tienen una solución lógica y accesible para cualquier usuario con un poco de paciencia. La clave está en no entrar en pánico, leer bien el mensaje de error (activando el modo debug si es necesario) y seguir los pasos uno a uno.

Si después de todo esto el problema persiste, no dudes en contactar con el soporte técnico de tu hosting. Si tu servidor usa Syspanel (recuerda, acceso por el puerto 2106), el equipo de soporte podrá revisar los logs del servidor y ayudarte de manera más directa.

Espero que esta guía PrestaShop te haya sido de gran ayuda. Recuerda que mantener tu tienda actualizada, con copias de seguridad periódicas y con un hosting de calidad, es la mejor manera de evitar estos problemas. ¡Mucho éxito con tu tienda online!