Cómo solucionar el error 500 en PrestaShop (hosting Plesk o cPanel)

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

El error 500 es uno de los más temidos por cualquier persona que tenga una tienda online con PrestaShop. La pantalla en blanco con el mensaje "Error interno del servidor" o "500 Internal Server Error" aparece sin previo aviso y puede bloquear por completo el acceso a tu tienda, tanto para ti como para tus clientes.

Lo primero que debes saber es que este error no significa que hayas perdido tus datos ni que tu tienda esté destruida. Simplemente indica que el servidor no puede procesar la petición que le has enviado, y la causa suele estar relacionada con un archivo de configuración, un módulo conflictivo o un problema de permisos en los archivos.

En este artículo te voy a explicar, paso a paso y sin tecnicismos innecesarios, cómo solucionar el error 500 PrestaShop cuando tu hosting es Plesk o cPanel. Ambos paneles de control son los más utilizados en el mundo del hosting compartido, así que es muy probable que tu tienda esté alojada en uno de ellos.

Antes de empezar, quiero que respires tranquilo. La mayoría de los errores 500 en PrestaShop se resuelven en menos de 30 minutos siguiendo un orden lógico de comprobaciones. Vamos a ello.

Primeros pasos: identifica el problema real

El error 500 es un "comodín" que puede esconder muchas causas diferentes. Por eso, lo más inteligente es no empezar a tocar archivos al azar, sino revisar los logs de tu servidor para saber exactamente qué está fallando.

¿Qué son los logs y cómo accedo a ellos?

Los logs son archivos de texto donde el servidor registra todo lo que ocurre, incluidos los errores. Son tu mejor aliado para solucionar cualquier problema técnico.

En cPanel:

1. Entra en tu panel de control de cPanel (normalmente en tudominio.com/cpanel).
2. Busca la sección Métricas o Registros.
3. Haz clic en "Errores" o "Error Log".
4. Verás una lista con los últimos errores registrados. Busca los que contengan la fecha y hora en que apareció el error 500 en tu tienda.

En Plesk:

1. Accede a Plesk con tus credenciales de administrador.
2. En el panel izquierdo, busca "Sitios web y dominios".
3. Haz clic en tu dominio.
4. Busca la sección "Registros" o "Logs" (dependiendo de la versión de Plesk).
5. Ahí encontrarás tanto el access log como el error log. Abre este último.

[TIP] Si tu hosting usa Syspanel (antes llamado HestiaCP), el acceso es por el puerto 2106. Dentro de Syspanel, los logs suelen estar en la pestaña "Registros" del dominio correspondiente. El proceso es similar: busca el archivo error.log o error_log.

¿Qué busco exactamente en los logs?

Una vez que tengas el log de errores abierto, busca líneas que contengan palabras como:

• "PHP Fatal error"
• "Parse error"
• "Permission denied"
• "Allowed memory size exhausted"
• "Class not found"

Estas líneas te darán pistas muy valiosas. Por ejemplo, si ves Allowed memory size exhausted, el problema es un límite de memoria PHP demasiado bajo. Si ves Permission denied, el problema son los permisos de archivos. Si ves Class not found, es un módulo que no se carga bien.

Soluciones paso a paso para el error 500 en PrestaShop

Ahora que tienes una idea de lo que puede estar pasando, vamos a aplicar soluciones concretas. Te recomiendo que sigas este orden, ya que va de lo más simple a lo más complejo.

1. Limpia la caché de PrestaShop

Una de las causas más comunes del error 500 PrestaShop es una caché corrupta. PrestaShop guarda archivos temporales de configuración y plantillas, y si uno de ellos se daña, todo el sistema puede fallar.

Cómo limpiar la caché en PrestaShop 1.7 u 8:

1. Accede a tu servidor por FTP o desde el administrador de archivos de tu panel de control.
2. Navega hasta la carpeta /var/cache dentro de la raíz de tu tienda.
3. Elimina todos los archivos y carpetas que haya dentro, pero no borres la carpeta cache en sí.
4. También puedes borrar el contenido de /var/cache/prod y /var/cache/dev si existen.

Si no tienes acceso por FTP, puedes hacerlo desde el administrador de archivos de cPanel o Plesk.

[WARNING] No borres la carpeta /var/cache completa, solo su contenido. Si la eliminas, PrestaShop la recreará automáticamente, pero es mejor prevenir.

Después de limpiar la caché, recarga tu tienda. Si el error persiste, sigue con el siguiente paso.

2. Aumenta el límite de memoria PHP

PrestaShop es una plataforma bastante exigente, especialmente si tienes muchos módulos activos o productos con muchas imágenes. El límite de memoria PHP por defecto (128 MB) puede quedarse corto.

Cómo aumentar el límite de memoria en cPanel:

1. Ve a la sección "Software" y haz clic en "Select PHP Version" o "MultiPHP INI Editor".
2. Busca la opción memory_limit.
3. Cámbiala a 256M o incluso 512M.
4. Guarda los cambios.

Cómo hacerlo en Plesk:

1. Ve a "Sitios web y dominios" y selecciona tu dominio.
2. Busca "Configuración PHP" o "PHP Settings".
3. Localiza memory_limit y cámbialo a 256M o 512M.
4. Aplica los cambios.

Otra alternativa, que funciona en ambos paneles, es editar el archivo .htaccess de tu tienda y añadir esta línea al final:

php_value memory_limit 512M

[INFO] Si tu hosting usa Syspanel (puerto 2106), puedes editar el archivo .htaccess desde el administrador de archivos. También puedes crear un archivo php.ini en la raíz con la línea memory_limit = 512M.

3. Comprueba y corrige los permisos de archivos

Los permisos incorrectos son otra causa muy frecuente del error 500 en PrestaShop. Si un archivo tiene permisos demasiado restrictivos, el servidor no puede leerlo ni ejecutarlo.

Los permisos correctos para PrestaShop son:

• Carpetas: 755
• Archivos: 644
• Archivos de configuración especiales (como config/settings.inc.php en versiones antiguas): 444 o 440

Cómo corregir permisos en cPanel:

1. Abre el Administrador de Archivos.
2. Ve a la raíz de tu tienda.
3. Selecciona todos los archivos y carpetas.
4. Haz clic en "Permisos" en la barra superior.
5. Marca la casilla para aplicar de forma recursiva.
6. Pon 755 para carpetas y 644 para archivos.

En Plesk:

1. Ve a "Sitios web y dominios" y entra en tu dominio.
2. Haz clic en "Administrador de archivos".
3. Selecciona todo y usa la opción "Cambiar permisos".
4. Aplica los mismos valores: 755 para carpetas, 644 para archivos.

[WARNING] Ten cuidado con el archivo config/settings.inc.php en PrestaShop 1.6. Este archivo debe tener permisos 444 o 440 para mayor seguridad. Si lo pones en 644, puede generar un error de seguridad y, en algunos casos, el error 500.

4. Desactiva módulos conflictivos

Un módulo mal configurado o incompatible con tu versión de PrestaShop puede provocar el error 500. El problema es que, si el error ocurre al cargar la tienda, no podrás desactivar el módulo desde el panel de administración.

Solución: renombrar la carpeta del módulo

1. Accede por FTP o administrador de archivos.
2. Navega a la carpeta /modules.
3. Busca los módulos que hayas instalado o actualizado recientemente.
4. Renombra la carpeta del módulo sospechoso añadiendo un guion bajo al principio (por ejemplo, _nombre_modulo).

Esto desactiva el módulo sin necesidad de entrar al panel. Recarga tu tienda y comprueba si el error desaparece. Si es así, ya sabes cuál es el culpable.

[TIP] Los módulos que más suelen dar problemas son los de pago, los de caché y los de SEO. Si tienes uno de estos, empieza por ahí.

5. Edita el archivo .htaccess

El archivo .htaccess de PrestaShop es fundamental para el funcionamiento de las URLs amigables y otras funciones. Si está corrupto o tiene directivas incompatibles con tu servidor, puede provocar el error 500.

Cómo regenerar el .htaccess:

1. Accede a la raíz de tu tienda por FTP.
2. Busca el archivo .htaccess.
3. Renómbralo a .htaccess_old.
4. Recarga tu tienda. PrestaShop generará uno nuevo automáticamente.

Si esto no funciona, puedes crear uno manualmente. Un .htaccess básico para PrestaShop 1.7 u 8 sería:

# Use PHP 8.0
AddType application/x-httpd-php .php

# BEGIN PrestaShop
<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteCond %{HTTP_HOST} ^tudominio.com$
    RewriteRule . - [E=REWRITEBASE:/]
    RewriteRule ^api/?(.*)$ webservice/$1 [QSA,L]
    RewriteRule ^.*$ - [NC,L]
</IfModule>
# END PrestaShop

[INFO] Sustituye tudominio.com por tu dominio real. Este es solo un ejemplo básico; lo ideal es que PrestaShop genere el archivo automáticamente.

6. Revisa la versión de PHP

PrestaShop necesita una versión de PHP compatible para funcionar correctamente. Si tu hosting ha actualizado PHP automáticamente y tu versión de PrestaShop es antigua, es muy probable que aparezca el error 500.

Versiones recomendadas:

• PrestaShop 1.6: PHP 5.6 o 7.0 (mejor 7.0)
• PrestaShop 1.7: PHP 7.1 a 7.4
• PrestaShop 8: PHP 7.4 a 8.1

Cómo cambiar la versión de PHP en cPanel:

1. Ve a "Select PHP Version".
2. Elige la versión compatible con tu PrestaShop.
3. Guarda los cambios.

En Plesk:

1. Ve a "Sitios web y dominios".
2. Haz clic en "Configuración PHP".
3. Selecciona la versión de PHP deseada.
4. Aplica los cambios.

[WARNING] Si cambias la versión de PHP, asegúrate de que los módulos que usas son compatibles con esa versión. Puedes comprobarlo en la ficha de cada módulo en el marketplace de PrestaShop.

7. Revisa el archivo de configuración de la base de datos

En PrestaShop 1.6, el archivo config/settings.inc.php contiene los datos de conexión a la base de datos. Si estos datos son incorrectos (por ejemplo, si has cambiado la contraseña de la base de datos y no has actualizado este archivo), el error 500 es inevitable.

Qué comprobar:

1. Accede al archivo config/settings.inc.php.
2. Verifica que database_host, database_name, database_user y database_password son correctos.
3. Si algo no coincide, corrígelo y guarda el archivo.

En PrestaShop 1.7 y 8, los datos de conexión están en el archivo app/config/parameters.php.

8. Desactiva el modo de desarrollo (si está activo)

Si has estado desarrollando o probando tu tienda, es posible que el modo de desarrollo esté activado. En este modo, PrestaShop muestra errores en pantalla, pero también puede generar conflictos con algunos servidores.

Cómo desactivarlo:

1. Ve a la carpeta /app/config.
2. Abre el archivo defines.inc.php.
3. Busca la línea define('_PS_MODE_DEV_', true);.
4. Cámbiala a define('_PS_MODE_DEV_', false);.
5. Guarda el archivo.

¿Y si nada de esto funciona? Soluciones avanzadas

Si has probado todos los pasos anteriores y el error 500 PrestaShop persiste, no te desesperes. Aún quedan algunas opciones.

Restaura una copia de seguridad

Si tienes una copia de seguridad reciente de tu tienda (del día anterior o de hace unos días), restaurarla puede ser la solución más rápida y segura. La mayoría de los hostings con cPanel o Plesk ofrecen copias de seguridad automáticas.

En cPanel:

1. Ve a la sección "Archivos" y haz clic en "Copias de seguridad".
2. Restaura la copia más reciente de tu cuenta.

En Plesk:

1. Ve a "Sitios web y dominios".
2. Haz clic en "Copias de seguridad".
3. Selecciona la copia que quieras restaurar y haz clic en "Restaurar".

[TIP] Antes de restaurar, descarga la copia de seguridad actual a tu ordenador. Así, si la restauración no funciona, puedes volver al estado anterior.

Contacta con tu proveedor de hosting

Si después de todo esto el error sigue ahí, es hora de pedir ayuda profesional. Contacta con el soporte técnico de tu hosting y explícales:

1. Que tienes un error 500 en PrestaShop.
2. Qué has probado ya (para que no te hagan repetir pasos).
3. Dales el contenido de los logs de error.

Los técnicos de hosting tienen acceso a los logs del servidor a nivel de sistema y pueden detectar problemas que tú no ves, como límites de recursos, problemas de disco o conflictos con otros sitios en el mismo servidor.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 significa que he perdido mis productos y pedidos?

No. El error 500 es un error del servidor, no de tu base de datos. Tus productos, pedidos y clientes están guardados en la base de datos MySQL y no se ven afectados por este error. Una vez que soluciones el problema, todo volverá a estar en su sitio.

¿Puedo evitar el error 500 en el futuro?

En muchos casos, sí. Algunas buenas prácticas son:

• Mantén PrestaShop actualizado a la última versión estable.
• No instales módulos de fuentes no oficiales.
• Haz copias de seguridad periódicas de tu tienda.
• No modifiques archivos del núcleo (core) de PrestaShop sin saber lo que haces.
• Revisa los logs de tu servidor de vez en cuando para detectar problemas antes de que se conviertan en errores graves.

¿Es mejor usar cPanel o Plesk para PrestaShop?

Ambos paneles son perfectamente compatibles con PrestaShop. La elección depende más de tu proveedor de hosting y de tus preferencias personales. cPanel suele ser más popular en hosting compartido, mientras que Plesk es más común en servidores VPS y dedicados. Lo importante es que el panel te permita acceder a los logs, gestionar PHP y editar archivos, y ambos lo hacen.

¿El error 500 tiene relación con el SEO de mi tienda?

Sí, y es importante que lo sepas. Si el error 500 persiste durante varias horas, los buscadores como Google pueden empezar a indexar la página de error y esto puede afectar negativamente a tu posicionamiento. Además, si tus clientes no pueden acceder a la tienda, perderás ventas. Por eso es tan importante solucionarlo lo antes posible.

¿Puedo usar el modo de mantenimiento de Presta