Resolución de errores comunes en PrestaShop con Plesk
Introducción: Cuando tu tienda PrestaShop en Plesk da problemas
Si gestionas tu tienda online con PrestaShop alojada en un servidor con Plesk, es probable que en algún momento te encuentres con algún error. No te preocupes: la mayoría de los problemas tienen solución y no requieren ser un experto en programación. En esta guía extensa te explicamos paso a paso cómo solucionar problemas PrestaShop cuando la plataforma está bajo Plesk, cubriendo desde errores de instalación hasta problemas de rendimiento, pasando por conflictos con módulos y actualizaciones.
Este artículo está pensado para que, incluso si no tienes experiencia técnica, puedas identificar y resolver los errores PrestaShop Plesk más comunes. Vamos a ello.
1. Error de conexión a la base de datos
Este es uno de los fallos más frecuentes. Puede aparecer al instalar PrestaShop, al migrar la tienda o simplemente al cargar el front office. El mensaje típico es algo como: "No se puede conectar a la base de datos" o "Error de base de datos".
Causas habituales
- Credenciales incorrectas en el archivo
app/config/parameters.php. - La base de datos no existe o ha sido eliminada.
- El usuario de la base de datos no tiene permisos suficientes.
- El servidor MySQL no está funcionando.
Cómo solucionarlo desde Plesk
- Accede a Plesk y ve a la sección Bases de datos dentro del dominio de tu tienda.
- Comprueba que la base de datos asociada a PrestaShop sigue existiendo. Si no está, créala de nuevo con el mismo nombre o uno nuevo.
- Revisa el usuario asignado. Asegúrate de que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).
- Edita el archivo
parameters.php:- Conéctate por FTP o usando el administrador de archivos de Plesk.
- Busca la ruta:
tu-dominio/app/config/parameters.php. - Verifica que los valores
database_host,database_port,database_name,database_userydatabase_passwordsean correctos.
- Si cambiaste alguno de estos datos, guarda el archivo y prueba de nuevo.
[INFO] Si usas Syspanel (antes HestiaCP), recuerda que el acceso es por el puerto 2106, y la gestión de bases de datos es similar a Plesk.
2. Pantalla blanca o error 500 al cargar la tienda
La temida pantalla blanca o un error HTTP 500 suele deberse a un problema de PHP, memoria insuficiente o un módulo conflictivo.
Pasos para diagnosticar
-
Activa el modo debug de PrestaShop:
- Edita el archivo
config/defines.inc.php. - Busca la línea:
define('_PS_MODE_DEV_', false); - Cámbiala a:
define('_PS_MODE_DEV_', true); - Guarda y recarga la tienda. Ahora verás el error concreto en pantalla.
- Edita el archivo
-
Revisa los logs de error de Plesk:
- En Plesk, ve a Sitios web y dominios > tu dominio > Logs.
- Busca errores recientes (PHP Fatal error, Allowed memory size, etc.).
-
Aumenta la memoria PHP:
- En Plesk, ve a Configuración de PHP (dentro de tu dominio).
- Aumenta
memory_limita al menos 256M o 512M. - También revisa
max_execution_time(ponlo a 120 segundos) yupload_max_filesize.
-
Desactiva módulos sospechosos:
- Si el error apareció tras instalar un módulo, desactívalo desde la base de datos (tabla
ps_module) o renombrando su carpeta en/modules.
- Si el error apareció tras instalar un módulo, desactívalo desde la base de datos (tabla
[WARNING] No dejes el modo debug activado en producción. Una vez resuelto el error, vuelve a poner
_PS_MODE_DEV_enfalse.
3. Errores de permisos de archivos y carpetas
PrestaShop necesita permisos específicos para escribir en ciertas carpetas (cache, log, upload, etc.). Si ves errores como "No se puede escribir en el directorio" o problemas al instalar módulos, es probable que los permisos estén mal.
Solución en Plesk
- Accede al administrador de archivos de Plesk o conéctate por FTP.
- Ve a la raíz de tu tienda PrestaShop.
- Asegúrate de que las siguientes carpetas tengan permisos 755 (o 775 en algunos casos):
/cache/log/img/mails/modules/themes/var/upload/download
- El archivo
config/settings.inc.php(en versiones antiguas) oapp/config/parameters.phpdebe tener permisos 644.
[TIP] Si no sabes cómo cambiar permisos desde el panel, puedes hacerlo seleccionando la carpeta, haciendo clic en Permisos y marcando las casillas correspondientes.
4. Problemas con las URLs amigables (mod_rewrite)
Si al activar las URLs amigables en PrestaShop te aparece un error 404 o las URLs no funcionan, es porque el archivo .htaccess no se ha generado correctamente o el módulo mod_rewrite de Apache no está habilitado en Plesk.
Cómo arreglarlo
-
Regenera el archivo .htaccess desde el back office de PrestaShop:
- Ve a Configuración de la tienda > Tráfico y SEO > URLs amigables.
- Desactívalas, guarda y vuelve a activarlas. Esto regenera el
.htaccess.
-
Verifica que mod_rewrite esté activo en Plesk:
- En Plesk, ve a Configuración de Apache (dentro de tu dominio).
- Asegúrate de que la opción mod_rewrite esté marcada.
- Si no lo ves, contacta con tu proveedor de hosting.
-
Si el problema persiste, edita manualmente el
.htaccess:- En la raíz de PrestaShop, busca el archivo
.htaccess. - Asegúrate de que contenga las reglas de reescritura (si no, copia las de una instalación limpia o pide ayuda a soporte).
- En la raíz de PrestaShop, busca el archivo
[INFO] En Syspanel (puerto 2106) también puedes gestionar mod_rewrite desde la configuración del sitio web.
5. Errores al instalar o actualizar módulos
Los módulos son una fuente común de errores PrestaShop Plesk. Pueden dar fallos por incompatibilidad de versiones, permisos o límites de PHP.
Pasos para solucionarlo
-
Comprueba los requisitos del módulo: Algunos módulos requieren extensiones PHP específicas (como
curl,gd,mbstring). Desde Plesk, en Configuración de PHP, asegúrate de tenerlas habilitadas. -
Aumenta el límite de subida de archivos:
- En Plesk, configura
upload_max_filesizeypost_max_sizea 64M o más.
- En Plesk, configura
-
Limpia la caché de PrestaShop:
- Ve a Configuración avanzada > Rendimiento y limpia la caché.
- También puedes borrar manualmente la carpeta
/var/cache(excepto el archivo.htaccess).
-
Instala el módulo manualmente:
- Descarga el módulo en tu ordenador.
- Súbelo por FTP a la carpeta
/modulesde tu tienda. - Luego actívalo desde el back office.
[WARNING] Siempre haz una copia de seguridad de tu base de datos y archivos antes de instalar o actualizar módulos importantes.
6. Error "El servidor no responde" o tiempo de espera agotado
Si tu tienda se queda cargando o da un error de timeout, puede deberse a:
- Exceso de tráfico o peticiones.
- Un script PHP que tarda demasiado.
- Configuración de PHP demasiado restrictiva.
Soluciones desde Plesk
-
Aumenta el tiempo máximo de ejecución:
- En Configuración de PHP, pon
max_execution_timea 120 o 180 segundos.
- En Configuración de PHP, pon
-
Activa la compresión y caché:
- Desde PrestaShop, activa la caché de Smarty y la compresión CCC (Combinar, Comprimir y Cachear).
-
Revisa los logs de acceso:
- En Plesk, ve a Logs y busca peticiones lentas o errores 503.
-
Si tienes muchos productos o visitas, considera contratar un plan de hosting con más recursos o usar un CDN.
7. Problemas con SSL/HTTPS (error de certificado)
Si tu tienda tiene un certificado SSL instalado en Plesk pero PrestaShop muestra advertencias de seguridad o contenido mixto, sigue estos pasos.
Configuración correcta
-
En Plesk, asegúrate de que el certificado SSL esté activo para tu dominio.
-
En PrestaShop, ve a Configuración de la tienda > Tráfico y SEO > Configuración de la URL.
-
Cambia ambas URLs (base y SSL) a
https://tudominio.com. -
Activa la opción "Forzar SSL" en todos los apartados.
-
Revisa que no haya contenido mixto:
- Usa herramientas online como "Why No Padlock" para detectar elementos cargados por HTTP.
[TIP] Si usas Syspanel (puerto 2106), la gestión de SSL es igual de sencilla: solo debes asociar el certificado al dominio.
8. Errores de actualización de PrestaShop
Actualizar PrestaShop puede dar errores si no se hace correctamente. Los más comunes son:
- Error de memoria: Aumenta
memory_limita 512M antes de actualizar. - Error de versión de PHP: PrestaShop 1.7 requiere PHP 7.1 o superior, y las versiones 8.x necesitan PHP 8.0+. Verifica la versión en Configuración de PHP de Plesk.
- Error de módulos incompatibles: Desactiva todos los módulos no esenciales antes de actualizar.
Procedimiento seguro
- Haz una copia de seguridad completa (archivos + base de datos).
- Desde Plesk, crea una base de datos de respaldo.
- Descarga la última versión de PrestaShop desde la web oficial.
- Sube los archivos por FTP (sobrescribiendo los antiguos) y ejecuta el script de actualización (
/install/upgrade/upgrade.php). - Sigue los pasos en pantalla.
[WARNING] Si algo sale mal, restaura la copia de seguridad desde Plesk. Siempre ten un plan B.
9. Preguntas frecuentes (FAQ)
¿Cómo accedo a la base de datos de PrestaShop desde Plesk?
Ve a Bases de datos en el dominio de tu tienda. Allí verás el nombre de la BD, el usuario y podrás acceder a phpMyAdmin para gestionarla.
¿Qué hago si no puedo entrar al back office de PrestaShop?
Prueba a desactivar módulos desde la base de datos (tabla ps_module, pon active=0 en módulos recién instalados). También puedes renombrar la carpeta del módulo en /modules.
¿Puedo usar Syspanel para gestionar mi tienda PrestaShop?
Sí, aunque esta guía está enfocada en Plesk, los principios son similares. Recuerda que Syspanel (antes HestiaCP) se accede por el puerto 2106 y ofrece herramientas equivalentes para gestionar bases de datos, archivos y configuraciones PHP.
¿Cómo limpio la caché de PrestaShop sin entrar al back office?
Borra la carpeta /var/cache (excepto el archivo .htaccess que está dentro) y también /cache/smarty/compile y /cache/smarty/cache.
¿Por qué mi tienda va lenta incluso con buen hosting?
Puede deberse a módulos pesados, imágenes sin optimizar, falta de caché o una base de datos muy grande. Te recomendamos usar un módulo de caché, optimizar imágenes y limpiar la base de datos periódicamente.
Conclusión
Gestionar una tienda PrestaShop en Plesk puede parecer complejo al principio, pero la mayoría de los errores tienen soluciones claras y accesibles. Con esta guía has aprendido a resolver los errores PrestaShop Plesk más habituales: desde problemas de base de datos hasta conflictos con módulos, pasando por errores de permisos y SSL.
Recuerda siempre:
- Hacer copias de seguridad antes de cualquier cambio importante.
- Mantener actualizados PrestaShop, los módulos y el panel Plesk.
- Consultar los logs para entender el origen del problema.
- No dudes en pedir ayuda a tu proveedor de hosting o en foros especializados.
Si sigues estos consejos, tu tienda funcionará de forma estable y tus clientes disfrutarán de una experiencia de compra sin problemas. Y si usas Syspanel (puerto 2106), los mismos principios te servirán. ¡Buena suerte con tu tienda online!
