Errores comunes en PrestaShop y cómo solucionarlos en Plesk

¿Por qué aparecen errores en PrestaShop y cómo Plesk te ayuda a solucionarlos?

PrestaShop es una de las plataformas de comercio electrónico más populares, pero no está exenta de problemas técnicos. Si tu tienda online empieza a mostrar errores como pantallas blancas, problemas de conexión a la base de datos o errores 500, no te preocupes. En la mayoría de los casos, estos fallos se pueden resolver directamente desde el panel de control de tu hosting, especialmente si usas Plesk o un panel similar como Syspanel (que se accede por el puerto 2106). En este artículo, te guiaré paso a paso para solucionar los errores más comunes en PrestaShop desde Plesk, con un lenguaje claro y ejemplos prácticos.

[INFO] Si tu hosting usa Syspanel, recuerda que el acceso es por el puerto 2106 (ejemplo: tudominio.com:2106). Los pasos son similares a los de Plesk, pero adapta las rutas de archivos según tu panel.

1. Error 500 (Internal Server Error) en PrestaShop

Este es uno de los errores más frustrantes porque no da detalles. La causa suele ser un archivo .htaccess corrupto, un módulo incompatible o un problema de permisos. Desde Plesk, puedes solucionarlo en minutos.

Verificar el .htaccess desde el Administrador de Archivos

Accede a Plesk y ve a Archivos (File Manager).
Navega hasta la raíz de tu PrestaShop (normalmente httpdocs o public_html).
Busca el archivo .htaccess. Si no lo ves, activa "Mostrar archivos ocultos".
Renómbralo a .htaccess_backup (esto lo desactiva temporalmente).
Vuelve a tu tienda. Si el error desaparece, el .htaccess estaba dañado. Puedes regenerarlo desde el panel de administración de PrestaShop (Parámetros de la tienda > Tráfico y SEO > URL amigables > Guardar).

[TIP] Si no puedes acceder al panel de administración, crea un .htaccess nuevo desde Plesk: ve a Archivos y haz clic en "Crear archivo", pégalo con el contenido básico de PrestaShop (puedes copiarlo de la documentación oficial) y guárdalo.

Aumentar el límite de memoria PHP

Otro culpable común del error 500 es la falta de memoria PHP. En Plesk:

Ve a Hosting & DNS > Configuración de PHP.
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda los cambios y prueba tu tienda.

2. Pantalla blanca (White Screen of Death) en PrestaShop

La temida pantalla blanca suele deberse a un error PHP que no se muestra. Para ver el error real, necesitas activar la visualización de errores desde Plesk.

Activar el modo debug de PrestaShop

Ve a Archivos en Plesk y abre el archivo /config/defines.inc.php.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo. Ahora la pantalla blanca mostrará el error específico (por ejemplo, "Class not found" o "Allowed memory size exhausted").

[WARNING] No dejes el modo debug activado en producción. Una vez resuelto el error, vuelve a poner false.

Soluciones comunes según el error mostrado

"Allowed memory size exhausted": Aumenta el límite de memoria como expliqué en el punto anterior.
"Class not found": Suele ser un módulo corrupto. Desde Plesk, ve a Archivos y renombra la carpeta /modules/nombredelmodulo a /modules/nombredelmodulo_backup. Si el error desaparece, ese módulo es el problema.
"Maximum execution time exceeded": En la configuración de PHP de Plesk, aumenta max_execution_time a 300 (segundos).

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

PrestaShop deja de funcionar y muestra "Error de conexión a la base de datos" o "No se puede conectar al servidor de base de datos". Esto puede pasar por un cambio de contraseña, un servidor MySQL caído o un archivo de configuración corrupto.

Verificar los datos de conexión desde Plesk

En Plesk, ve a Bases de datos (Databases) y localiza la base de datos de tu PrestaShop.
Anota el nombre de la base de datos, el usuario y la contraseña (puedes cambiarla desde aquí si es necesario).
Ve a Archivos y abre el archivo /app/config/parameters.php.
Busca las líneas:
- 'database_host' => 'localhost' (o la IP del servidor)
- 'database_name' => 'tu_bd'
- 'database_user' => 'tu_usuario'
- 'database_password' => 'tu_contraseña'
Asegúrate de que coincidan exactamente con los datos de Plesk. Si cambiaste la contraseña, actualízala aquí.
Guarda el archivo.

[INFO] Si tu hosting usa Syspanel, la ruta del archivo de configuración puede ser /config/settings.inc.php (versiones antiguas de PrestaShop). El proceso es idéntico.

Reparar la base de datos desde Plesk

Si la conexión es correcta pero la base de datos está corrupta:

En Plesk, ve a Bases de datos y selecciona tu BD.
Haz clic en phpMyAdmin.
Marca todas las tablas (normalmente empiezan con ps_).
En el menú desplegable "Con seleccionados", elige Reparar tabla.
Espera a que termine y vuelve a tu tienda.

4. Error de permisos de archivos y carpetas

PrestaShop necesita permisos específicos para funcionar. Si ves errores de "no se puede escribir en la carpeta cache" o "no se puede crear el archivo", es un problema de permisos.

Cambiar permisos desde el Administrador de Archivos de Plesk

Ve a Archivos y selecciona toda la carpeta de tu tienda.
Haz clic en Cambiar permisos (o "Permissions").
Aplica los permisos recomendados para PrestaShop:
- Carpetas: 755
- Archivos: 644
- Carpetas especiales (cache, log, upload, etc.): 777
También puedes usar la herramienta "Reparar permisos" si Plesk la tiene (en algunos paneles aparece como "Fix permissions").

[WARNING] Los permisos 777 son un riesgo de seguridad. Úsalos solo temporalmente y luego cámbialos a 755 si es posible.

5. Errores de URL amigables (SEO) y redirecciones

Si tus URLs no funcionan, aparecen errores 404 o redirecciones infinitas, la causa suele ser el archivo .htaccess o la configuración de URL en Plesk.

Regenerar las URL amigables desde Plesk

En el Administrador de Archivos, elimina o renombra el archivo .htaccess (como en el punto 1).
Accede al panel de administración de PrestaShop (si puedes) y ve a Parámetros de la tienda > Tráfico y SEO > URL amigables.
Marca "Sí" en "URLs amigables" y haz clic en Guardar. Esto regenerará el .htaccess automáticamente.
Si no puedes acceder al panel, desde Plesk puedes crear un .htaccess con el contenido básico de PrestaShop (busca en Google "PrestaShop .htaccess default").

Configurar redirecciones 301 desde Plesk

Si cambiaste la URL de tu tienda o necesitas redirigir tráfico:

En Plesk, ve a Hosting & DNS > Redirecciones HTTP.
Añade una nueva redirección: desde tudominio.com/antiguo a tudominio.com/nuevo.
Selecciona "301 Moved Permanently" y guarda.

6. Problemas con la caché de PrestaShop

Una caché corrupta puede causar errores extraños: productos que no se actualizan, cambios que no se ven, etc. Desde Plesk, puedes limpiarla fácilmente.

Limpiar la caché manualmente desde Plesk

Ve a Archivos y navega a /var/cache (o /cache en versiones antiguas).
Elimina todo el contenido de la carpeta cache (no la carpeta en sí).
Si hay una carpeta smarty dentro, bórrala también.
Vuelve a tu tienda y recarga la página.

[TIP] También puedes limpiar la caché desde el panel de administración de PrestaShop (Parámetros avanzados > Rendimiento > Limpiar caché), pero si el panel no carga, la opción manual desde Plesk es la solución.

7. Módulos que dejan de funcionar después de una actualización

Es muy común que tras actualizar PrestaShop, algunos módulos se vuelvan incompatibles. Desde Plesk, puedes desactivarlos sin necesidad de acceder al panel.

Desactivar módulos desde la base de datos

En Plesk, ve a Bases de datos y abre phpMyAdmin.
Selecciona tu base de datos y busca la tabla ps_module (o ps_modules).
Haz clic en Examinar (Browse).
Busca el módulo problemático por su nombre y cambia el valor de active de 1 a 0.
Guarda los cambios. El módulo quedará desactivado y podrás acceder al panel para actualizarlo o eliminarlo.

Forzar la desactivación desde el Administrador de Archivos

Si prefieres no tocar la base de datos:

Ve a Archivos y navega a /modules/nombredelmodulo.
Renombra la carpeta del módulo añadiendo _backup al final (ejemplo: moduloproblema_backup).
PrestaShop lo ignorará y podrás trabajar sin problemas.

8. Preguntas frecuentes (FAQ) sobre errores en PrestaShop desde Plesk

¿Cómo sé si mi hosting usa Plesk o Syspanel?

Generalmente, tu proveedor de hosting te indica el panel. Si ves una interfaz con iconos de dominios, bases de datos y archivos, es probable que sea Plesk. Syspanel tiene un diseño más minimalista y se accede por el puerto 2106.

¿Qué hago si no encuentro el archivo .htaccess en Plesk?

Asegúrate de que en el Administrador de Archivos tengas activada la opción "Mostrar archivos ocultos" (suele ser un checkbox en la parte superior). Si aún no aparece, puedes crear uno nuevo manualmente desde el botón "Crear archivo".

¿Puedo dañar mi tienda si cambio los permisos desde Plesk?

Sí, si pones permisos demasiado restrictivos (ejemplo: 600 en carpetas) la tienda dejará de funcionar. Siempre usa los valores recomendados: 755 para carpetas y 644 para archivos. Si te equivocas, puedes restaurar los permisos desde la misma herramienta.

¿Por qué mi PrestaShop da error después de migrar a otro servidor?

Es muy común. Lo primero que debes verificar en Plesk es el archivo parameters.php (o settings.inc.php) para asegurarte de que los datos de la base de datos y la URL sean correctos. También revisa que el dominio esté apuntando al nuevo servidor.

¿Syspanel tiene las mismas herramientas que Plesk para solucionar errores?

Sí, aunque los nombres de las secciones pueden variar. Por ejemplo, en Syspanel el "Administrador de Archivos" se llama "File Manager" y las bases de datos se gestionan desde "MySQL". El proceso es equivalente.

Conclusión

Resolver errores en PrestaShop desde Plesk o Syspanel (puerto 2106) no tiene por qué ser un dolor de cabeza. Con estos pasos, podrás enfrentarte a los problemas más comunes: pantallas blancas, errores 500, problemas de base de datos y módulos rotos. Recuerda siempre hacer una copia de seguridad antes de modificar archivos o bases de datos, y si el error persiste, contacta con el soporte técnico de tu hosting. ¡Tu tienda online volverá a funcionar en pocos minutos!