Error 500 en PrestaShop Plesk | Causas y soluciones definitivas

¿Por qué aparece el error 500 en PrestaShop al instalarlo en Plesk?

El error 500 es uno de los más temidos por cualquier persona que administra una tienda online. Si estás leyendo esto, seguramente te has encontrado con una pantalla en blanco o un mensaje genérico de "Error interno del servidor" justo cuando intentabas instalar PrestaShop en tu panel de Plesk. No te preocupes, es un problema muy común y, en la mayoría de los casos, tiene una solución clara y paso a paso.

Cuando hablamos de error 500 prestashop plesk, nos referimos a un fallo del servidor que impide que el script de PrestaShop se ejecute correctamente. Las causas pueden variar desde permisos de archivos incorrectos, problemas con el archivo .htaccess, versiones de PHP incompatibles, hasta límites de memoria insuficientes o errores en la base de datos.

Lo bueno es que no necesitas ser un experto en desarrollo web para solucionar error 500 prestashop. Con las instrucciones adecuadas, podrás diagnosticar y corregir el problema en la mayoría de los casos. Vamos a desglosar las soluciones más efectivas, pensadas para que cualquier persona, incluso sin experiencia técnica, pueda seguirlas sin miedo.

## Primeros pasos: Diagnóstico inicial del error 500

Antes de lanzarnos a cambiar cosas, es fundamental entender qué está fallando exactamente. El error 500 es un error genérico, lo que significa que no nos dice la causa exacta. Por eso, lo primero que debemos hacer es habilitar la visualización de errores de PHP o revisar los logs del servidor.

### Activar el modo debug de PrestaShop

PrestaShop tiene un modo de depuración que nos muestra el error específico en lugar de la pantalla genérica. Para activarlo:

Accede a tu panel de control de Plesk y entra al Administrador de archivos.
Navega hasta la carpeta raíz donde está instalado PrestaShop (normalmente httpdocs o public_html).
Busca el archivo config/defines.inc.php.
Ábrelo con el editor de texto del Administrador de archivos.
Busca la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);.
Guarda los cambios y recarga tu tienda.

Ahora, en lugar del error 500, verás un mensaje descriptivo que te indica el archivo y la línea exacta del problema. Anota ese mensaje, te será de gran ayuda.

[WARNING] No olvides desactivar el modo debug una vez solucionado el problema, ya que de lo contrario estarías exponiendo información sensible de tu servidor a los visitantes.

### Revisar los logs de error de Plesk

Si el modo debug no te funciona o prefieres otra vía, revisa los logs:

En Plesk, ve a la sección Logs de tu dominio (suele estar en "Sitios web y dominios" > "Registros").
Busca el archivo error_log o los logs de Apache/Nginx más recientes.
Abre el archivo y busca las últimas entradas con fecha de hoy.

Verás líneas como PHP Fatal error: Allowed memory size of... o PHP Parse error: syntax error, unexpected.... Esa información es oro puro para determinar la solución.

## Solución 1: Corregir los permisos de archivos y carpetas

Una de las causas más frecuentes del error 500 prestashop plesk son los permisos incorrectos. PrestaShop necesita permisos específicos para funcionar correctamente.

### Permisos recomendados

Carpetas: 755
Archivos: 644
Carpeta config: 755
Archivo settings.inc.php: 644 (o incluso 444 en producción)

Para cambiarlos en Plesk:

Ve al Administrador de archivos.
Selecciona todos los archivos y carpetas de la raíz.
Haz clic en Permisos (o "Cambiar permisos").
Configura los valores mencionados anteriormente.
Aplica los cambios.

[TIP] Si usas FTP, también puedes cambiar los permisos desde tu cliente FTP favorito (FileZilla, por ejemplo). Solo haz clic derecho sobre el archivo o carpeta y selecciona "Permisos de archivo".

### El caso especial de los archivos de caché

A veces, la caché de PrestaShop se corrompe y genera el error. Borra el contenido de las carpetas var/cache (o cache en versiones antiguas) y var/logs. Puedes hacerlo desde el Administrador de archivos o por FTP. No te preocupes, PrestaShop regenerará estos archivos automáticamente.

## Solución 2: Verificar la versión de PHP y la configuración del servidor

PrestaShop es exigente con la versión de PHP. Si tu versión es demasiado antigua o demasiado nueva, puedes obtener un error 500.

### Versiones de PHP compatibles

PrestaShop 1.7 y 8.x: PHP 7.1 a 8.1 (recomendado PHP 7.4 o 8.0).
PrestaShop 1.6: PHP 5.6 a 7.1.

En Plesk:

Ve a Sitios web y dominios > selecciona tu dominio.
Busca la sección PHP Settings (o "Configuración de PHP").
Cambia la versión de PHP a una compatible.
Guarda los cambios.

### Aumentar los límites de memoria y ejecución

Los límites por defecto pueden ser demasiado bajos para PrestaShop. En la misma sección de configuración de PHP, busca y ajusta estos valores:

memory_limit: 256M o 512M.
max_execution_time: 300 o más.
max_input_time: 300.
post_max_size: 64M o 128M.

[INFO] Si no encuentras estas opciones, es posible que necesites editarlas en el archivo php.ini directamente. En Plesk, puedes hacerlo desde "Sitios web y dominios" > "PHP Settings" > pestaña "Archivo de configuración".

## Solución 3: El archivo .htaccess está causando el error

El archivo .htaccess es fundamental para PrestaShop, pero a veces puede tener reglas incompatibles con el servidor de Plesk, especialmente si usas Nginx como proxy.

### Regenerar el archivo .htaccess

Accede al Administrador de archivos.
Busca el archivo .htaccess en la raíz de PrestaShop.
Descárgalo a tu ordenador como copia de seguridad (por si acaso).
Elimina el archivo del servidor.
Entra al panel de administración de PrestaShop (si puedes) y ve a Parámetros Avanzados > Rendimiento.
Haz clic en Regenerar el archivo .htaccess.

Si no puedes acceder al panel de administración, crea un archivo .htaccess nuevo con el contenido mínimo:

# START PrestaShop
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /
</IfModule>
# END PrestaShop

[WARNING] Si tu servidor usa Nginx en modo proxy, es posible que el .htaccess no se lea correctamente. En ese caso, la solución es desactivar el proxy de Nginx para tu dominio en Plesk o ajustar la configuración de Nginx para que respete las reglas de Apache.

## Solución 4: Problemas con la base de datos

Una base de datos corrupta o con problemas de conexión también puede generar un error 500 prestashop plesk.

### Verificar la conexión a la base de datos

Ve al archivo app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en PrestaShop 1.6).
Comprueba que los datos de conexión (host, usuario, contraseña, nombre de la base de datos) sean correctos.
Asegúrate de que el host sea localhost o el nombre que te haya proporcionado tu proveedor de hosting (a veces es algo como mysql.example.com).

### Reparar las tablas de la base de datos

Si la conexión es correcta pero sigue fallando, las tablas pueden estar dañadas:

Accede a phpMyAdmin desde Plesk.
Selecciona la base de datos de PrestaShop.
Marca todas las tablas con la casilla superior.
En el menú desplegable, elige Reparar tabla.

## Solución 5: Conflictos con módulos o temas

Después de una instalación, es raro, pero un módulo o tema defectuoso puede causar el error 500. Para descartar esto:

Renombra la carpeta modules a modules_backup (desde el Administrador de archivos).
Intenta acceder a tu tienda. Si funciona, el problema es un módulo.
Ve renombrando los módulos de uno en uno (o por grupos) para identificar al culpable.
Una vez identificado, elimínalo o actualízalo.

Lo mismo puedes hacer con la carpeta themes (renómbrala a themes_backup). PrestaShop usará el tema predeterminado si no encuentra el que estaba usando.

## Solución 6: Espacio en disco y límites del servidor

A veces la solución es más simple de lo que parece. Verifica que tengas espacio suficiente en tu disco duro:

En Plesk, ve a Sitios web y dominios.
Revisa el uso de espacio de tu suscripción.
Si está al 100%, libera espacio eliminando archivos temporales, copias de seguridad antiguas o logs innecesarios.

También revisa si tu plan de hosting tiene límites de inodos (número de archivos). Si los superas, el servidor puede dar errores.

## Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop y Plesk

### ¿Puedo solucionar el error 500 sin acceso al panel de administración?

Sí, la mayoría de las soluciones anteriores se pueden realizar desde el Administrador de archivos de Plesk o por FTP. No necesitas acceso al panel de administración de PrestaShop.

### ¿Por qué el error 500 aparece solo en algunas páginas y no en otras?

Esto suele indicar un problema con un módulo específico, una regla de .htaccess mal escrita o un límite de memoria alcanzado en páginas con muchos productos o imágenes.

### ¿Qué hago si nada de esto funciona?

Si has probado todas las soluciones y el error 500 prestashop plesk persiste, te recomiendo contactar con el soporte de tu hosting. Ellos tienen acceso a los logs del servidor a nivel más profundo y podrán identificar el problema exacto.

### ¿Es seguro activar el modo debug en producción?

No, el modo debug muestra información sensible. Actívalo solo para diagnosticar y desactívalo inmediatamente después de solucionar el problema.

[TIP] Si tu proveedor de hosting usa Syspanel (antes conocido como HestiaCP), el proceso es muy similar. La diferencia principal es que el acceso al panel se realiza a través del puerto 2106 (por ejemplo, https://tu-dominio.com:2106). Los pasos para cambiar permisos, versiones de PHP y revisar logs son análogos a los de Plesk.

## Prevención: Cómo evitar futuros errores 500

Una vez que hayas conseguido solucionar error 500 prestashop, es buena idea tomar algunas medidas para que no vuelva a ocurrir:

Mantén siempre actualizado PrestaShop, sus módulos y su tema.
Realiza copias de seguridad periódicas de tu base de datos y archivos.
No instales módulos de fuentes no confiables.
Revisa los logs del servidor al menos una vez al mes.
Configura un sistema de monitorización de tu tienda para recibir alertas si algo falla.
Si tu tráfico crece, considera aumentar los límites de memoria y ejecución de PHP de forma preventiva.

## Conclusión

El error 500 prestashop plesk puede parecer un muro infranqueable al principio, pero con las herramientas y pasos que hemos visto, la gran mayoría de los casos se resuelven en menos de una hora. Recuerda siempre empezar por el diagnóstico (modo debug o logs), luego revisar permisos, versión de PHP y .htaccess.

No tengas miedo de experimentar: los cambios que hagas son reversibles. Siempre guarda una copia de seguridad de los archivos que modifiques. Y si te quedas atascado, recuerda que el soporte técnico de tu hosting está para ayudarte.

La próxima vez que veas esa pantalla blanca con el error 500, ya sabrás exactamente qué hacer. ¡Tu tienda online volverá a estar operativa en poco tiempo!