Errores comunes en PrestaShop con Plesk | FAQ y soluciones

¿Tu tienda PrestaShop que funciona con Plesk está dando problemas? No te preocupes, es más común de lo que crees. Esta FAQ está diseñada para resolver los errores PrestaShop más frecuentes que ocurren en entornos Plesk, de forma clara y sin tecnicismos. Aquí encontrarás soluciones paso a paso para que tu tienda vuelva a funcionar sin complicaciones.

1. La tienda muestra un error 500 (Internal Server Error)

Este es uno de los errores PrestaShop más habituales. Sucede cuando algo falla en la configuración del servidor o en los archivos de la tienda. No te asustes, suele tener una solución sencilla.

Posibles causas y soluciones

Archivo .htaccess dañado o incorrecto: Este archivo controla las reglas de acceso a tu tienda. Si se corrompe, da error 500.
- Solución: Accede a tu panel de Plesk, ve a "Administrador de archivos" dentro del dominio de tu tienda, localiza el archivo .htaccess en la raíz, renómbralo a .htaccess.old y luego ve al panel de administración de PrestaShop (si puedes acceder) para regenerarlo desde "Configuración > Parámetros generales > Generar .htaccess". Si no puedes entrar, crea un .htaccess nuevo con el siguiente contenido básico:
```
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
```
Permisos de archivos incorrectos: Los archivos de PrestaShop necesitan permisos específicos.
- Solución: En Plesk, ve a "Administrador de archivos", selecciona toda la carpeta de tu tienda (normalmente httpdocs o public_html), haz clic en "Permisos" y asegúrate de que las carpetas tengan 755 y los archivos 644. No uses 777, es inseguro.
Módulo incompatible o mal configurado: Un módulo recién instalado o actualizado puede provocar el error.
- Solución: Si puedes acceder al panel de administración, desactiva el último módulo que instalaste desde "Módulos > Gestor de módulos". Si no, renombra la carpeta del módulo sospechoso en /modules/ desde el Administrador de archivos de Plesk (por ejemplo, añade _old al nombre).

[WARNING] Antes de modificar archivos, siempre haz una copia de seguridad de tu tienda desde Plesk (Herramientas > Copias de seguridad). Así podrás restaurar si algo sale mal.

2. Error de conexión a la base de datos

Este error aparece cuando PrestaShop no puede comunicarse con la base de datos MySQL. Verás un mensaje como "No se puede conectar a la base de datos" o "Error de base de datos".

Causas y pasos para solucionarlo

Credenciales incorrectas en el archivo de configuración:
- Solución: En Plesk, ve a "Administrador de archivos", abre la carpeta de tu tienda y localiza el archivo app/config/parameters.php. Ábrelo con el editor de texto. Busca las líneas:
```
'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',
```
  Verifica que estos datos coincidan con los de tu base de datos en Plesk. Puedes ver las credenciales en "Bases de datos" dentro del panel de Plesk.
Base de datos caída o sobrecargada:
- Solución: Desde Plesk, ve a "Bases de datos", selecciona la de tu tienda y haz clic en "Comprobar". Si aparece algún error, repárala. Si el servidor está muy cargado, contacta con tu proveedor de hosting.
Usuario de base de datos sin permisos:
- Solución: En Plesk, en "Bases de datos", selecciona la base de datos y ve a "Usuarios". Asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, edita y asígnaselos.

[TIP] Si usas Syspanel (antes conocido como HestiaCP), recuerda que accedes por el puerto 2106. Allí, la gestión de bases de datos es similar: ve a "Base de datos" y verifica las credenciales y permisos.

3. La tienda carga muy lento o se queda en blanco

Un rendimiento pobre puede deberse a varios factores. Aquí tienes las soluciones más efectivas.

Optimizaciones rápidas desde Plesk

Habilitar la caché de PrestaShop:
- Solución: Entra al panel de administración de tu tienda, ve a "Configuración > Rendimiento". Activa la caché (recomendada: "Sistema de archivos" o "Memcached" si tu servidor lo soporta). También activa la combinación y compresión de CSS y JavaScript y la compresión HTML.
Actualizar PrestaShop y módulos:
- Solución: Las versiones antiguas son más lentas y vulnerables. Desde el panel de administración, ve a "Ayuda > Acerca de" para ver tu versión. Si hay actualizaciones, instálalas. También actualiza todos los módulos desde "Módulos > Gestor de módulos".
Revisar el uso de recursos en Plesk:
- Solución: En Plesk, ve a "Estadísticas" o "Monitor de recursos". Si el consumo de CPU o RAM es alto, considera contratar un plan superior o desactivar módulos pesados. También puedes activar la compresión Gzip en la configuración de Apache desde "Hosting & DNS > Configuración de Apache y nginx".

[INFO] Si tu tienda sigue lenta, revisa si tienes imágenes muy grandes. PrestaShop tiene una herramienta para redimensionarlas en "Configuración > Imágenes". Usa formatos modernos como WebP.

4. Error "500 Internal Server Error" después de mover la tienda de servidor

Es muy común al migrar una tienda PrestaShop a un nuevo hosting con Plesk. El error suele deberse a diferencias en la configuración del servidor.

Pasos para resolverlo

Revisar la versión de PHP:
- Solución: PrestaShop necesita una versión específica de PHP (por ejemplo, 7.4 o 8.0 según la versión). En Plesk, ve a "Hosting & DNS" y selecciona tu dominio. En "PHP Settings", elige la versión correcta. Si usas PrestaShop 1.7, PHP 7.4 es estable; para 8.x, usa 8.0 o 8.1.
Verificar las extensiones de PHP necesarias:
- Solución: PrestaShop requiere extensiones como mysqli, gd, curl, json, mbstring, etc. En Plesk, en la misma sección de "PHP Settings", asegúrate de que estén habilitadas. Si no, actívalas.
Revisar el archivo parameters.php después de la migración:
- Solución: Como en el punto 2, verifica que las credenciales de la base de datos sean las del nuevo servidor. Si cambiaste el nombre de la base de datos o el usuario, actualiza el archivo.
Regenerar la caché de PrestaShop:
- Solución: Desde el panel de administración, ve a "Configuración > Rendimiento" y haz clic en "Limpiar caché". Si no puedes acceder, desde el Administrador de archivos de Plesk, elimina el contenido de las carpetas /var/cache/ (sin borrar las carpetas en sí).

[WARNING] No copies archivos de la caché antigua al nuevo servidor. Siempre limpia la caché después de una migración.

5. Error al enviar correos desde la tienda (formulario de contacto, pedidos, etc.)

Los correos no se envían o aparecen en spam. Esto afecta la comunicación con tus clientes.

Soluciones desde Plesk

Configurar correctamente el envío de correo:
- Solución: En el panel de administración de PrestaShop, ve a "Configuración > Parámetros generales > Contacto". Asegúrate de que la dirección de correo del remitente sea válida y esté configurada en el mismo dominio (por ejemplo, info@tutienda.com). Luego, en "Configuración > Parámetros avanzados > Correo", elige "Usar la función mail() de PHP" o "SMTP". Si usas SMTP, necesitarás los datos de tu servidor de correo (puedes obtenerlos en Plesk en "Correo > Configuración de SMTP").
Verificar la configuración de SPF y DKIM:
- Solución: Para que los correos no lleguen a spam, añade registros SPF y DKIM en tu dominio. En Plesk, ve a "Correo > Configuración de DNS" y activa las opciones de autenticación. Si no sabes cómo, contacta con tu proveedor de hosting.
Revisar los logs de correo en Plesk:
- Solución: En Plesk, ve a "Correo > Logs de correo" para ver si hay errores específicos. Si ves mensajes como "Connection refused", el servidor SMTP no está funcionando. Reinicia el servicio de correo desde "Herramientas > Servicios".

[TIP] Si tu tienda usa Syspanel (puerto 2106), la configuración de correo es similar. Ve a "Correo" y asegúrate de que el dominio tenga los registros DNS correctos.

6. Error al actualizar PrestaShop (pantalla blanca o errores)

Actualizar PrestaShop puede dar miedo, pero con estos pasos lo harás sin problemas.

Cómo evitar problemas en la actualización

Haz una copia de seguridad completa:
- Solución: En Plesk, ve a "Herramientas > Copias de seguridad" y crea una copia de todo el sitio y la base de datos. Guárdala en un lugar seguro.
Usa el asistente de actualización de PrestaShop:
- Solución: Descarga el módulo "1-Click Upgrade" desde el panel de administración (Módulos > Gestor de módulos). Sigue los pasos del asistente. No interrumpas el proceso.
Si aparece pantalla blanca después de actualizar:
- Solución: Accede a tu tienda por FTP o al Administrador de archivos de Plesk. Abre el archivo /config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Esto mostrará los errores exactos. Luego, desactiva módulos incompatibles renombrando sus carpetas en /modules/. Una vez resuelto, vuelve a poner _PS_MODE_DEV_ en false.

[INFO] Si la actualización falla, restaura la copia de seguridad desde Plesk y prueba de nuevo. A veces hay que actualizar módulos primero.

7. Error "No se puede escribir en la carpeta de caché" o permisos

Este error impide que PrestaShop funcione correctamente, ya que no puede guardar archivos temporales.

Solución paso a paso

Corregir permisos desde Plesk:
- Solución: En el Administrador de archivos de Plesk, selecciona las carpetas /cache/, /log/, /upload/ y /img/. Haz clic en "Permisos" y asígnales 755. Si usas un servidor con Apache, también puedes dar permisos 775 si el usuario del servidor es diferente.
Cambiar el propietario de los archivos:
- Solución: En Plesk, ve a "Hosting & DNS" y selecciona tu dominio. En "Configuración de hosting", busca "Propietario del sistema" y asegúrate de que sea el mismo que el usuario de FTP. Si no, cambia el propietario desde el Administrador de archivos (opción "Cambiar propietario").
Desactivar el modo de seguridad de PHP:
- Solución: En Plesk, en "PHP Settings", desactiva "open_basedir" si está activado. Esto a veces restringe el acceso a carpetas.

[WARNING] No uses permisos 777 en ninguna carpeta. Es un riesgo de seguridad. Si el problema persiste, contacta con tu hosting.

8. Error al cargar imágenes (productos, categorías, etc.)

Las imágenes no se suben o se ven rotas. Esto puede deberse a límites de tamaño o configuración de PHP.

Soluciones desde Plesk

Aumentar el límite de subida de archivos:
- Solución: En Plesk, ve a "Hosting & DNS" > "PHP Settings". Aumenta los valores de upload_max_filesize, post_max_size y memory_limit. Por ejemplo, ponlos en 64M o 128M. Guarda los cambios.
Verificar la carpeta de imágenes:
- Solución: Asegúrate de que la carpeta /img/ tenga permisos 755 y que no esté llena. Desde el Administrador de archivos, revisa si hay archivos temporales y elimínalos.
Regenerar miniaturas:
- Solución: En el panel de administración, ve a "Configuración > Imágenes" y haz clic en "Regenerar miniaturas". Esto arreglará imágenes rotas.

[TIP] Si usas Syspanel (puerto 2106), los límites de PHP se configuran en "Configuración del servidor" > "PHP". Allí también puedes ajustar estos valores.

9. Error 404 en páginas de producto o categoría

Las URLs de tu tienda no funcionan, dando error 404. Esto suele deberse a reglas de reescritura mal configuradas.

Cómo solucionarlo

Regenerar el archivo .htaccess:
- Solución: Entra al panel de administración de PrestaShop, ve a "Configuración > Parámetros generales" y en "URLs amigables", haz clic en "Guardar" (aunque no cambies nada). Esto regenera el .htaccess. Si no puedes acceder, desde el Administrador de archivos de Plesk, elimina el .htaccess y luego crea uno nuevo con el contenido básico del punto 1.
Activar las URLs amigables:
- Solución: En la misma sección, asegúrate de que "URLs amigables" esté activado. Si no, actívalo y guarda.
Revisar la configuración de Apache en Plesk:
- Solución: En Plesk, ve a "Hosting & DNS" > "Configuración de Apache y nginx". Asegúrate de que "mod_rewrite" esté habilitado. Si no, actívalo y reinicia Apache desde "Herramientas > Servicios".

[INFO] Si después de esto sigues viendo errores 404, es posible que tengas un módulo de SEO que esté interfiriendo. Desactívalo temporalmente para probar.

10. Error al instalar un módulo o tema

No puedes instalar un módulo o tema porque aparece un error de permisos o incompatibilidad.

Pasos para resolverlo

Verificar la compatibilidad con tu versión de PrestaShop:
- Solución: Antes de instalar, revisa que el módulo o tema sea compatible con tu versión de PrestaShop (1.6, 1.7, 8.x). En la página de descarga suele indicarlo.
Aumentar el límite de memoria de PHP:
- Solución: Como en el punto 8, en Plesk, aumenta memory_limit a 256M o más. Esto ayuda a la instalación de módulos pesados.
Instalar manualmente desde el Administrador de archivos:
- Solución: Si la instalación automática falla, descarga el módulo en tu ordenador, descomprímelo y súbelo a la carpeta /modules/ de tu tienda mediante el Administrador de archivos de Plesk o FTP. Luego, desde el panel de administración, ve a "Mód