Cómo resolver errores comunes de PrestaShop en Plesk

¿Tu tienda PrestaShop se ha vuelto loca en Plesk? No te preocupes, es más común de lo que crees. Plesk es un panel de control potente, pero a veces la combinación con PrestaShop puede dar algunos quebraderos de cabeza. En esta guía, vamos a desgranar los fallos más frecuentes y, lo más importante, cómo solucionarlos paso a paso. Al final, serás capaz de diagnosticar y resolver problemas como un experto.

[INFO] Esta guía está diseñada para usuarios de Plesk. Si usas otro panel como Syspanel (accesible por el puerto 2106), algunos pasos pueden variar ligeramente, pero la lógica es la misma.

Errores de Base de Datos en PrestaShop con Plesk

Uno de los problemas más habituales al trabajar con PrestaShop en Plesk son los errores relacionados con la base de datos. Suelen aparecer como pantallas en blanco o mensajes crípticos como "Error de conexión a la base de datos" o "Table 'ps_xxx' doesn't exist". Vamos a ver cómo solucionarlos.

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

Este error suele deberse a que las credenciales de acceso a la base de datos no son correctas o el servidor MySQL no está funcionando.

Pasos para solucionarlo:

1. Verifica que MySQL está activo: Accede a Plesk y ve a "Herramientas y Ajustes" > "Servicios". Busca "MySQL" y asegúrate de que está en verde (ejecutándose). Si está en rojo, haz clic en "Iniciar".
2. Revisa las credenciales en el archivo de configuración: Conéctate a tu servidor por FTP o usa el administrador de archivos de Plesk. Busca el archivo /config/settings.inc.php en la raíz de tu PrestaShop. Ábrelo y verifica que las líneas _DB_SERVER_, _DB_NAME_, _DB_USER_ y _DB_PASSWD_ coinciden exactamente con los datos de la base de datos que creaste en Plesk.
3. Comprueba el usuario y los privilegios: En Plesk, ve a "Bases de datos", selecciona la tuya y luego "Usuarios". Asegúrate de que el usuario que usas tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) marcados.
4. Prueba la conexión manualmente: Puedes usar una herramienta como phpMyAdmin (desde Plesk) para intentar conectar con las mismas credenciales. Si falla, el problema está en las credenciales o en la configuración del servidor.

[TIP] Si cambiaste la contraseña de la base de datos desde Plesk, recuerda actualizarla también en el archivo settings.inc.php. Es un error muy común.

Tablas corruptas o faltantes ("Table 'ps_xxx' doesn't exist")

Este error suele ocurrir tras una actualización fallida, una migración incompleta o un problema con el motor de almacenamiento (MyISAM vs InnoDB).

Soluciones prácticas:

• Reparar las tablas: Desde Plesk, accede a phpMyAdmin. Selecciona tu base de datos, marca todas las tablas (o las que den error) y en el menú desplegable elige "Reparar tabla". Esto suele arreglar problemas menores.
• Ejecutar una consulta de reparación: Si phpMyAdmin no lo resuelve, puedes ejecutar directamente la consulta SQL: REPAIR TABLE nombre_de_la_tabla;. Sustituye "nombre_de_la_tabla" por la que falla.
• Restaurar desde una copia de seguridad: Si la reparación no funciona, la opción más segura es restaurar la base de datos desde una copia de seguridad reciente. En Plesk, ve a "Bases de datos", selecciona tu base de datos y usa la opción "Importar" para subir un archivo SQL de respaldo.

[WARNING] Siempre haz una copia de seguridad de tu base de datos antes de intentar reparaciones o restauraciones. Un paso en falso podría empeorar las cosas.

Errores de Archivos y Permisos en PrestaShop con Plesk

PrestaShop es muy sensible a los permisos de archivos y carpetas. Un error típico es ver una pantalla en blanco (el famoso "White Screen of Death") o mensajes como "Cannot write to file" o "Permission denied".

La pantalla en blanco (White Screen of Death)

Este es uno de los fallos comunes de PrestaShop en Plesk que más desesperan. Las causas pueden ser varias, pero los permisos suelen ser el principal sospechoso.

Diagnóstico y solución paso a paso:

1. Activa el modo debug de PrestaShop: Edita el archivo /config/defines.inc.php. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Esto mostrará los errores PHP en pantalla, dándote una pista más clara.
2. Revisa los permisos de carpetas: Plesk gestiona los permisos de forma un poco diferente. Ve a "Archivos" en el dominio de tu tienda. Asegúrate de que las carpetas /cache, /log, /img, /upload, /download y /themes tengan permisos 755 (o 775 si hay problemas). Los archivos dentro de ellas deben tener 644 (o 664).
3. Verifica el propietario de los archivos: En Plesk, los archivos deben pertenecer al usuario del sistema del dominio. Si has subido archivos por FTP con otro usuario, puede dar problemas. Usa la opción "Cambiar propietario" en el menú de archivos de Plesk para ajustarlo.
4. Borra la caché de PrestaShop: A veces una caché corrupta causa la pantalla en blanco. Borra manualmente el contenido de la carpeta /cache/smarty/compile, /cache/smarty/cache y /cache/class_index.php. Si no puedes, usa un cliente FTP para eliminar los archivos.

[INFO] Si después de activar el modo debug ves un error de memoria (como "Allowed memory size exhausted"), tendrás que aumentar el límite de memoria PHP. En Plesk, ve a "PHP Settings" de tu dominio y sube el valor de memory_limit a 256M o 512M.

Error al instalar o actualizar módulos

Al instalar un módulo, puede aparecer un error de escritura o de permisos. Esto es muy común en solucionar problemas PrestaShop Plesk.

Pasos para resolverlo:

1. Ajusta los permisos de la carpeta /modules: Asegúrate de que la carpeta /modules tenga permisos 755 y que el propietario sea el correcto.
2. Desactiva el caché de PrestaShop temporalmente: Ve al back office de PrestaShop (si puedes acceder) a "Parámetros Avanzados" > "Rendimiento" y desactiva "Caché de Smarty" y "Caché de CSS/JS". Prueba a instalar el módulo de nuevo.
3. Instala el módulo manualmente: Sube la carpeta del módulo por FTP a /modules y luego actívalo desde el back office. Esto evita problemas con el instalador automático.

Errores de Configuración de PHP y Servidor

PrestaShop necesita una configuración PHP específica para funcionar correctamente. Plesk te permite ajustarla fácilmente, pero a veces los valores por defecto no son los adecuados.

Límites de memoria y tiempo de ejecución

Si ves errores como "Fatal error: Allowed memory size exhausted" o "Maximum execution time exceeded", es hora de ajustar PHP.

Cómo hacerlo en Plesk:

1. Ve a "Hosting & DNS" > "PHP Settings" en el dominio de tu tienda.
2. Busca los siguientes parámetros y ajústalos a estos valores recomendados:
   • memory_limit: 256M (o 512M si tienes muchos módulos)
   • max_execution_time: 120 (o 180)
   • max_input_time: 120
   • upload_max_filesize: 64M
   • post_max_size: 64M
3. Haz clic en "Aceptar" y el servidor se recargará automáticamente.

[TIP] Si usas una versión antigua de PHP (como 5.6 o 7.0), considera migrar a PHP 7.4 o 8.0, ya que PrestaShop 1.7 y superiores funcionan mucho mejor con versiones modernas.

Errores de redirección (bucles de redirección)

A veces, al activar la URL amigable o SSL, entras en un bucle de redirección que impide cargar la tienda.

Soluciones para Plesk:

• Revisa la configuración de HTTPS: En Plesk, ve a "Hosting & DNS" > "Hosting Settings". Asegúrate de que la opción "Redireccionar HTTP a HTTPS" está activada y que la URL de tu tienda comienza con https://.
• Limpia la caché de redirecciones: PrestaShop guarda las reglas de redirección en el archivo .htaccess. Bórralo desde el administrador de archivos de Plesk y luego, desde el back office de PrestaShop (si puedes acceder), ve a "Parámetros Avanzados" > "Rendimiento" y haz clic en "Limpiar caché". Luego, ve a "Parámetros de la tienda" > "Tráfico y SEO" y guarda la configuración de URL amigable para regenerar el .htaccess.
• Verifica las reglas de redirección: Si tienes reglas personalizadas en el .htaccess, pueden estar causando conflictos. Temporalmente, renómbralo a .htaccess.old para ver si el problema se soluciona.

Preguntas Frecuentes (FAQ) sobre errores PrestaShop Plesk

¿Por qué mi tienda PrestaShop se ve en blanco después de una actualización en Plesk?

Esto suele deberse a un conflicto de versiones de PHP o a módulos no compatibles. Primero, activa el modo debug como explicamos antes. Luego, verifica que tu versión de PHP en Plesk es compatible con la de PrestaShop. Por último, desactiva todos los módulos no esenciales desde la base de datos (en la tabla ps_module).

¿Cómo puedo aumentar el límite de memoria en Plesk para PrestaShop?

Ve a "PHP Settings" de tu dominio y cambia memory_limit a 256M o 512M. Si no funciona, puede que tu plan de hosting tenga restricciones. Contacta con tu proveedor.

¿Qué hago si no puedo acceder al back office de PrestaShop en Plesk?

Prueba a acceder directamente mediante la URL tudominio.com/admin1234 (sustituye "admin1234" por tu carpeta de administración). Si no funciona, revisa los permisos de la carpeta /admin y el archivo config/settings.inc.php. También puedes intentar desactivar módulos desde la base de datos (tabla ps_module, cambiando active a 0 en todos).

¿Es normal que aparezcan errores de "500 Internal Server Error" en PrestaShop con Plesk?

Sí, es un fallo común de PrestaShop en Plesk. Suele deberse a un .htaccess corrupto o a un error de PHP fatal. Renombra el .htaccess a .htaccess.old y prueba a cargar la tienda. Si funciona, regenera el archivo desde el back office. Si no, revisa los logs de error de Plesk (en "Logs" del dominio) para encontrar la causa exacta.

¿Cómo puedo migrar mi PrestaShop de otro panel (como Syspanel, puerto 2106) a Plesk?

La migración implica exportar la base de datos desde el panel anterior (por ejemplo, usando phpMyAdmin en Syspanel), importarla en Plesk, y luego copiar todos los archivos de la tienda por FTP. Después, deberás editar el archivo settings.inc.php para que apunte a la nueva base de datos en Plesk. Es un proceso delicado, así que asegúrate de tener copias de seguridad.

[WARNING] Si vienes de Syspanel (puerto 2106), presta especial atención a los permisos de archivos, ya que los sistemas de usuarios pueden ser diferentes. En Plesk, asegúrate de que el propietario de los archivos es el usuario del dominio.

Con esta guía, ya tienes las herramientas para solucionar problemas PrestaShop Plesk por ti mismo. Recuerda siempre hacer copias de seguridad antes de tocar nada y, si te sientes perdido, no dudes en contactar con el soporte técnico de tu hosting. ¡Buena suerte con tu tienda!