Errores comunes de PrestaShop en Plesk y cómo solucionarlos

Si tienes una tienda online con PrestaShop alojada en un servidor Plesk, es probable que en algún momento te encuentres con pantallas en blanco, errores de conexión a la base de datos o problemas con los módulos. No te preocupes, es algo habitual. Esta guía está diseñada para que, paso a paso, puedas identificar y resolver los errores PrestaShop Plesk más comunes sin necesidad de ser un experto en programación. Aquí aprenderás a activar el modo debug, interpretar los mensajes de error y aplicar soluciones prácticas para que tu tienda vuelva a funcionar correctamente.

¿Por qué ocurren errores en PrestaShop en Plesk?

PrestaShop es un sistema complejo que depende de muchos factores: la versión de PHP, los permisos de archivos, la configuración de la base de datos y el servidor web. Plesk, por su parte, es un panel de control potente pero con configuraciones específicas que a veces entran en conflicto con los requisitos de PrestaShop. Los errores más frecuentes suelen deberse a:

Versiones de PHP incompatibles (PrestaShop 1.7 necesita PHP 7.1 o superior, pero no PHP 8.0+ sin actualizar).
Permisos de archivos incorrectos (carpetas sin capacidad de escritura).
Problemas de memoria PHP (límite muy bajo).
Módulos desactualizados o conflictivos.
Errores en el archivo .htaccess (especialmente al activar URLs amigables).
Base de datos corrupta o con tablas rotas.

A continuación, te mostramos cómo diagnosticar y solucionar cada uno paso a paso.

Activar el modo debug en PrestaShop (el primer paso)

Antes de lanzarte a hacer cambios, necesitas ver el error real. Por defecto, PrestaShop oculta los mensajes de error y muestra una pantalla blanca (el famoso "White Screen of Death"). Para ver qué está pasando, debes activar el modo debug.

Cómo activar el modo debug desde Plesk

Accede a tu panel de Plesk (normalmente en https://tudominio.com:8443).
Ve a Archivos o Administrador de archivos (depende de la versión de Plesk).
Navega hasta la carpeta raíz de tu tienda (donde está el archivo index.php de PrestaShop).
Busca el archivo config/defines.inc.php y edítalo.

Localiza la línea que dice:

define('_PS_MODE_DEV_', false);

Cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda los cambios.

[INFO] A partir de ahora, en lugar de una pantalla en blanco, verás mensajes de error detallados (PHP, SQL, etc.). Anota el texto del error porque te servirá para buscar la solución exacta.

¿Qué hacer si no puedes editar defines.inc.php?

Si el archivo no se abre o no tienes permisos, puedes crear un archivo llamado config/defines_custom.inc.php con el siguiente contenido:

<?php
define('_PS_MODE_DEV_', true);

Esto activa el modo debug sin modificar el archivo original. Una vez resuelto el error, puedes borrar este archivo o cambiar true por false.

Errores comunes de PrestaShop en Plesk y sus soluciones

A continuación, los errores más frecuentes que reportan los usuarios de PrestaShop en servidores Plesk, junto con las soluciones prácticas.

Error de conexión a la base de datos

Síntomas: Mensaje como "Cannot connect to database" o "Error de conexión a la base de datos".
Causa: Datos incorrectos en el archivo app/config/parameters.php o la base de datos está caída.

Solución paso a paso:

Ve a Plesk > Bases de datos y verifica que la base de datos de tu tienda aparezca y tenga estado "Activo".
Abre el archivo app/config/parameters.php (en la raíz de PrestaShop).
Comprueba que los valores database_host, database_name, database_user y database_password coincidan exactamente con los datos de tu base de datos en Plesk.
Si cambiaste la contraseña de la base de datos desde Plesk, actualízala también en parameters.php.
Guarda el archivo y recarga la tienda.

[TIP] Si usas Plesk, es común que el database_host sea localhost. Pero en algunos servidores compartidos puede ser una IP como 127.0.0.1 o el nombre del servidor. Consulta con tu proveedor de hosting si no funciona.

Pantalla en blanco (White Screen of Death)

Síntomas: La página no carga nada, solo un fondo blanco.
Causa: Generalmente un error PHP fatal, memoria insuficiente o un módulo roto.

Solución:

Activa el modo debug (como explicamos arriba) para ver el mensaje de error.
Si el error dice "Allowed memory size of X bytes exhausted", necesitas aumentar el límite de memoria PHP.
- En Plesk, ve a PHP Settings (dentro de los ajustes del dominio).
- Busca la opción memory_limit y cámbiala a 256M o 512M.
- Guarda los cambios y reinicia el servicio PHP (Plesk suele hacerlo automáticamente).
Si el error menciona un módulo específico (ej: "Class 'MiModulo' not found"), desactívalo desde la base de datos:
- Accede a phpMyAdmin (desde Plesk, en la sección de bases de datos).
- Ejecuta esta consulta SQL:
```
UPDATE ps_module SET active = 0 WHERE name = 'nombre_del_modulo';
```
- Sustituye nombre_del_modulo por el nombre del módulo problemático (sin las comillas simples).

Error 500 Internal Server Error

Síntomas: Aparece un error 500 en toda la tienda o en páginas específicas.
Causa: Problemas con el archivo .htaccess o permisos de archivos.

Solución:

Desde Plesk > Archivos, ve a la raíz de tu tienda.
Busca el archivo .htaccess. Si existe, renómbralo a .htaccess_backup para desactivarlo temporalmente.
Recarga la tienda. Si funciona, el problema está en el .htaccess.
Regenera el archivo desde el panel de administración de PrestaShop: Configuración > Tráfico y SEO > URLs amigables y haz clic en Guardar (esto regenera el .htaccess).
Si el error persiste, verifica los permisos de las carpetas:
- Las carpetas deben tener permisos 755.
- Los archivos deben tener permisos 644.
- En Plesk, puedes seleccionar todos los archivos y usar la opción Cambiar permisos para ajustarlos en lote.

[WARNING] Nunca pongas permisos 777 en archivos o carpetas, a menos que sea absolutamente necesario y temporal. Es un riesgo de seguridad grave.

Error de módulo no compatible con la versión de PHP

Síntomas: Al instalar o actualizar un módulo, aparece un error como "This module is not compatible with your PHP version".
Causa: El módulo requiere una versión de PHP diferente a la que tienes configurada.

Solución:

En Plesk, ve a PHP Settings del dominio.
Cambia la versión de PHP a una compatible con tu PrestaShop:
- PrestaShop 1.7: PHP 7.1 a 7.4 (evita PHP 8.0+ a menos que tengas PrestaShop 8+).
- PrestaShop 8: PHP 7.4 o 8.0.
Guarda los cambios.
Si el módulo sigue dando error, contacta al desarrollador para una versión actualizada.

Error de caché corrupta

Síntomas: La tienda muestra productos antiguos, cambios que no se reflejan o errores extraños.
Causa: La carpeta de caché de PrestaShop está llena o corrupta.

Solución:

Desde Plesk > Archivos, navega a la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones anteriores).
Elimina todo el contenido de las carpetas dev y prod (o la carpeta cache completa).
No borres las carpetas en sí, solo su contenido.
Recarga la tienda. PrestaShop regenerará la caché automáticamente.

[INFO] Si no puedes borrar archivos desde el administrador de archivos de Plesk, usa el comando rm -rf por SSH (si tienes acceso) o contacta a soporte técnico.

Cómo prevenir futuros errores PrestaShop Plesk

Una vez que hayas solucionado el problema actual, te recomendamos adoptar estas buenas prácticas para minimizar errores futuros:

Mantén todo actualizado

PrestaShop: Actualiza a la última versión estable de tu rama (1.7.x o 8.x).
Módulos y temas: No uses versiones antiguas. Los módulos desactualizados son la principal causa de errores.
PHP en Plesk: Revisa periódicamente la versión de PHP y cámbiala solo si es compatible con tu PrestaShop.

Realiza copias de seguridad periódicas

Desde Plesk puedes programar copias de seguridad automáticas del dominio y la base de datos. Así, si algo sale mal, puedes restaurar en minutos.

Activa el registro de errores

Incluso cuando la tienda esté en producción, mantén el modo debug desactivado, pero activa el registro de errores en un archivo. En config/defines.inc.php, añade:

define('_PS_MODE_DEV_', false);
define('_PS_DISABLE_LOG_COLUMNS_', false);

Los errores se guardarán en var/logs/ (PrestaShop 1.7) o log/ (versiones anteriores). Revísalos cada cierto tiempo.

Preguntas frecuentes (FAQ)

¿Cómo sé qué versión de PHP tengo en Plesk?

Ve a Plesk > Sitios web y dominios > selecciona tu dominio > PHP Settings. Allí verás la versión actual.

¿Puedo cambiar la versión de PHP sin romper mi tienda?

Sí, pero siempre haz una copia de seguridad primero. Cambia de una versión a otra gradualmente (ej: de 7.1 a 7.4, no directamente a 8.0).

¿Qué hago si no veo el error aunque active el modo debug?

Revisa que el archivo config/defines.inc.php se haya guardado correctamente. También verifica que no haya un archivo config/defines_custom.inc.php que esté sobrescribiendo la configuración. Si todo falla, revisa los logs de error de PHP en Plesk (en Herramientas y configuración > Registros de errores).

Mi tienda va muy lenta, ¿puede ser un error de Plesk?

Sí, a veces el límite de memoria PHP o el tiempo de ejecución máximo son muy bajos. En PHP Settings de Plesk, aumenta max_execution_time a 120 y memory_limit a 256M. También revisa que el hosting no tenga límites de recursos muy restrictivos.

¿Debo usar el administrador de archivos de Plesk o FTP?

Ambos sirven, pero el administrador de archivos de Plesk es más seguro porque no expone contraseñas FTP. Además, desde Plesk puedes cambiar permisos fácilmente.

Conclusión

Resolver errores PrestaShop Plesk no tiene por qué ser una pesadilla. Con esta guía, activando el modo debug y siguiendo las soluciones paso a paso, podrás diagnosticar y arreglar la mayoría de los problemas sin ayuda externa. Recuerda siempre hacer una copia de seguridad antes de hacer cambios drásticos, y mantén tu tienda y servidor actualizados. Si el error persiste, no dudes en contactar a tu proveedor de hosting o a un desarrollador especializado. ¡Tu tienda online volverá a funcionar en poco tiempo!