Solucionar error 500 en PrestaShop con Plesk - Guía rápida

¿Qué es el error 500 en PrestaShop y por qué aparece en Plesk?

El error 500 (Internal Server Error) es uno de los más comunes y frustrantes en PrestaShop. Cuando tu tienda online muestra este error, significa que el servidor encontró un problema inesperado que le impide completar la petición. No te preocupes, no es culpa tuya ni de tu tienda necesariamente; suele ser un conflicto entre tu instalación de PrestaShop y la configuración del servidor Plesk.

Este error puede aparecer de repente, incluso después de haber funcionado perfectamente durante meses. Las causas más frecuentes incluyen:

Archivos .htaccess corruptos o mal configurados
Problemas de permisos en archivos y carpetas
Errores en módulos o temas de PrestaShop
Límites de memoria PHP insuficientes
Conflictos con la versión de PHP en Plesk
Errores en la base de datos

Lo bueno es que, en la mayoría de los casos, puedes solucionarlo tú mismo sin necesidad de contactar al soporte técnico. Vamos paso a paso.

Paso 1: Activar el modo debug de PrestaShop (para ver el error real)

Antes de hacer nada, necesitas saber qué está causando exactamente el error 500. PrestaShop tiene un modo de depuración que muestra el error real en lugar de la pantalla blanca genérica.

¿Cómo activarlo?

Accede a tu panel de Plesk y ve a Archivos o File Manager.
Navega hasta la carpeta raíz de tu PrestaShop (normalmente httpdocs o public_html).
Busca el archivo config/defines.inc.php.
Edítalo con el editor de texto de Plesk.
Busca la línea que dice:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
Guarda los cambios y recarga tu tienda.

[WARNING] No dejes el modo debug activado permanentemente. Una vez resuelto el problema, vuelve a ponerlo en false. De lo contrario, cualquier visitante podría ver información sensible de tu servidor.

Ahora, en lugar del error 500, verás un mensaje más descriptivo como "Fatal error: Allowed memory size exhausted" o "Class not found". Eso te dará pistas claras.

Paso 2: Verificar y restaurar el archivo .htaccess

El archivo .htaccess de PrestaShop es muy sensible. Un cambio incorrecto, una actualización fallida o incluso un módulo mal configurado pueden dañarlo.

¿Cómo solucionarlo?

En Plesk, ve a Archivos y localiza el archivo .htaccess en la raíz de tu PrestaShop.
Haz una copia de seguridad (descárgalo o renómbralo a .htaccess.bak).
Elimina el archivo .htaccess original.
Ve al panel de administración de PrestaShop (si puedes acceder). Si no puedes, salta al siguiente paso.
En el menú, ve a Configuración > Tráfico y SEO > URL amigables.
Sin hacer ningún cambio, haz clic en Guardar. Esto regenerará el .htaccess automáticamente.

[TIP] Si no puedes acceder al panel de administración, crea un archivo .htaccess nuevo desde cero con este contenido básico:

# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# END PrestaShop

Guárdalo y vuelve a probar tu tienda.

Paso 3: Ajustar los límites de memoria PHP

Uno de los culpables más frecuentes del error 500 en PrestaShop es que se agota la memoria PHP. PrestaShop recomienda al menos 256 MB de memoria.

En Plesk, haz lo siguiente:

Ve a Herramientas y configuraciones > Configuración de PHP (o busca "PHP Settings").
Selecciona el dominio de tu tienda.
Busca la opción memory_limit.
Cámbiala a 256M o incluso 512M si tu servidor lo permite.
Guarda los cambios.

Si no encuentras esa opción, puedes crearla manualmente:

En el Administrador de archivos de Plesk, ve a la raíz de tu PrestaShop.
Crea un archivo llamado php.ini (si no existe).
Agrega esta línea:
```
memory_limit = 256M
```
Guarda y recarga.

[INFO] Algunos servidores compartidos tienen límites estrictos. Si no puedes aumentar la memoria, contacta a tu proveedor de hosting.

Paso 4: Verificar permisos de archivos y carpetas

Los permisos incorrectos son otra causa común. PrestaShop necesita permisos específicos para funcionar.

Permisos correctos:

Archivos: 644 (rw-r--r--)
Carpetas: 755 (rwxr-xr-x)
Archivos de configuración (como config/settings.inc.php): 644

Cómo verificarlos en Plesk:

Ve a Archivos y selecciona todos los archivos y carpetas de tu PrestaShop.
Haz clic en Permisos (o Permissions).
Asegúrate de que las carpetas tengan 755 y los archivos 644.
Si ves algo incorrecto, cámbialo.

[WARNING] No pongas permisos 777 en ningún archivo o carpeta. Es un riesgo de seguridad grave.

Paso 5: Deshabilitar módulos y temas problemáticos

A veces, un módulo o tema recién instalado o actualizado puede romper tu tienda. Si el error 500 apareció después de instalar algo nuevo, esa es la causa más probable.

¿Cómo deshabilitar módulos sin acceso al panel?

En Plesk, ve a Bases de datos y selecciona la base de datos de tu PrestaShop.
Usa phpMyAdmin para acceder a ella.
Busca la tabla ps_module (el prefijo puede variar, por ejemplo, prestashop_module).
Localiza el módulo sospechoso y cambia su estado de 1 a 0 (activo a inactivo).
También puedes eliminar la fila completa si estás seguro.

Otra opción más sencilla: renombrar la carpeta del módulo en el servidor.

En Archivos de Plesk, ve a modules/.
Localiza la carpeta del módulo problemático.
Cámbiale el nombre, por ejemplo, añadiendo _disabled al final.
Recarga tu tienda.

[TIP] Si no sabes qué módulo es, renombra todos los módulos recién instalados o actualizados uno por uno hasta que el error desaparezca.

Paso 6: Verificar la versión de PHP en Plesk

PrestaShop requiere una versión específica de PHP. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.4 o 8.0, mientras que versiones antiguas pueden necesitar PHP 5.6.

Cómo cambiarla en Plesk:

Ve a Herramientas y configuraciones > Configuración de PHP.
Selecciona tu dominio.
En la parte superior, verás un menú desplegable con las versiones disponibles.
Elige la recomendada para tu versión de PrestaShop.
Guarda los cambios.

[INFO] Si tienes dudas sobre qué versión usar, consulta la documentación oficial de PrestaShop o el archivo README.md de tu instalación.

Paso 7: Revisar los logs del servidor en Plesk

Si después de todos los pasos anteriores el error 500 persiste, necesitas revisar los logs del servidor. Allí encontrarás el error exacto.

Cómo acceder a los logs en Plesk:

Ve a Herramientas y configuraciones > Logs (o Logs en el menú principal).
Busca los logs de Apache o Nginx (dependiendo de tu servidor).
También puedes revisar el error_log de PHP, que suele estar en la raíz de tu PrestaShop.
Busca entradas con la fecha y hora del error 500.

Los mensajes típicos incluyen:

PHP Fatal error: Allowed memory size exhausted
Class 'Module' not found
require_once(): Failed opening required

Con esa información, puedes buscar soluciones más específicas.

Preguntas frecuentes (FAQ)

¿El error 500 puede dañar mi tienda?

No, el error 500 es solo un problema de comunicación entre el servidor y PrestaShop. Tus productos, clientes y pedidos están seguros en la base de datos. Una vez solucionado, todo vuelve a la normalidad.

¿Necesito conocimientos técnicos para solucionarlo?

No necesariamente. Siguiendo esta guía paso a paso, cualquier persona puede resolverlo. Eso sí, ten cuidado al modificar archivos y siempre haz copias de seguridad.

¿Qué hago si no tengo acceso al panel de administración de PrestaShop?

No te preocupes. Todos los pasos que mencionamos se pueden hacer desde Plesk, ya sea mediante el Administrador de archivos, phpMyAdmin o la configuración de PHP.

¿El error 500 es culpa de mi hosting?

Puede serlo, pero no siempre. A veces es un conflicto con un módulo, un tema o una actualización. Si después de seguir toda la guía el error persiste, contacta a tu proveedor de hosting con los logs del servidor.

¿Puedo evitar que vuelva a ocurrir?

Sí, con buenas prácticas:

Mantén PrestaShop, módulos y temas actualizados.
Haz copias de seguridad periódicas.
No instales módulos de fuentes no confiables.
Monitorea los logs del servidor regularmente.

Resumen final

El error 500 en PrestaShop con Plesk puede parecer aterrador, pero en la mayoría de los casos tiene solución. Recuerda:

Activa el modo debug para ver el error real.
Revisa y restaura el .htaccess.
Aumenta la memoria PHP.
Verifica permisos de archivos y carpetas.
Deshabilita módulos problemáticos.
Ajusta la versión de PHP.
Consulta los logs del servidor.

Si después de todo esto el error persiste, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen acceso a configuraciones más profundas del servidor.

[TIP] Siempre ten a mano una copia de seguridad reciente de tu tienda. Así, si algo sale mal, puedes restaurarla rápidamente.

Esperamos que esta guía te haya sido útil. ¡Tu tienda online volverá a funcionar en poco tiempo!