Error 500 en PrestaShop: Causas y soluciones en cPanel/Plesk

¿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 gestiona una tienda online. Es un error genérico que significa "Error interno del servidor". Es decir, algo está fallando en el servidor donde se aloja tu PrestaShop, pero el sistema no te dice exactamente qué es.

Puede aparecer de varias formas: una página en blanco, un mensaje como "500 Internal Server Error", o a veces solo un texto muy corto. Lo peor es que puede ocurrir tanto en la parte pública de tu tienda como en el panel de administración.

Las causas más comunes son:

Un archivo .htaccess corrupto o con reglas incorrectas.
Permisos de archivos o carpetas mal configurados.
Un módulo o plugin que genera un conflicto.
Problemas de memoria PHP (límite demasiado bajo).
Una versión de PHP incompatible con tu PrestaShop.
Archivos del núcleo dañados o incompletos.

En este artículo te voy a explicar paso a paso cómo solucionar el error 500 en PrestaShop, tanto si usas cPanel como Plesk. No necesitas ser un experto técnico: solo sigue las instrucciones con calma y en orden.

Antes de empezar: prepara tu entorno de trabajo

Antes de tocar nada, es fundamental que hagas una copia de seguridad de tu tienda. El error 500 puede empeorar si modificas un archivo incorrecto sin tener un respaldo. Además, tener una copia te permitirá restaurar el estado anterior si algo sale mal.

Para hacer una copia de seguridad mínima necesitas:

Acceso al panel de control de tu hosting (cPanel o Plesk).
Acceso FTP o al administrador de archivos del hosting.
Un editor de texto plano (como el Bloc de notas o Visual Studio Code).

[WARNING] Nunca edites archivos de PrestaShop con editores como Word o Pages. Pueden añadir caracteres invisibles que rompan la tienda. Usa siempre editores de texto plano.

Otra recomendación: anota en un papel los cambios que vayas haciendo. Así podrás revertirlos si es necesario.

Solucionar error 500 en PrestaShop con cPanel

cPanel es uno de los paneles de control más utilizados en hosting compartido. Si tu hosting usa cPanel, sigue estos pasos.

1. Activa el modo de depuración (debug) de PrestaShop

El primer paso es hacer que PrestaShop te muestre el error real. Por defecto, el error 500 es muy poco informativo, pero PrestaShop tiene un modo de depuración que revela el problema exacto.

Para activarlo necesitas editar el archivo config/defines.inc.php. Este archivo se encuentra en la raíz de tu instalación de PrestaShop.

Sigue estos pasos:

Entra en tu cPanel y abre el Administrador de archivos.
Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html).
Abre la carpeta config y busca el archivo defines.inc.php.
Haz clic derecho sobre el archivo y selecciona Editar.
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala por define('_PS_MODE_DEV_', true);.
Guarda el archivo.

Ahora recarga tu tienda. En lugar del error 500, verás un mensaje de error detallado con la línea y el archivo que está causando el problema. Anota ese mensaje, te será muy útil.

[INFO] Si no ves ningún mensaje tras activar el modo dev, revisa el archivo config/defines.inc.php y asegúrate de que el cambio se guardó correctamente. También puedes consultar el archivo var/logs de tu instalación.

2. Restaura el archivo .htaccess

El archivo .htaccess de PrestaShop es muy delicado. Si está dañado, es la causa número uno del error 500.

Ve al Administrador de archivos de cPanel.
Busca el archivo .htaccess en la raíz de tu tienda. Si no lo ves, activa la opción "Mostrar archivos ocultos" en la configuración del administrador.
Renombra el archivo a .htaccess.bak (esto lo desactiva).
Ahora intenta acceder a tu tienda.

Si el error desaparece, el problema era el .htaccess. Para regenerarlo correctamente:

Entra en el panel de administración de PrestaShop (si puedes).
Ve a Parámetros avanzados > Rendimiento.
Busca la sección "Regenerar archivo .htaccess" y haz clic en el botón correspondiente.

Si no puedes entrar al panel de administración, puedes generar un .htaccess básico manualmente. Pero ten cuidado: si tienes reglas personalizadas de SEO o redirecciones, las perderás.

[TIP] Guarda siempre una copia de tu .htaccess original cuando funcione correctamente. Así podrás restaurarlo rápidamente en caso de problemas.

3. Revisa los permisos de archivos y carpetas

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

En cPanel:

Abre el Administrador de archivos.
Selecciona todos los archivos y carpetas de la raíz de tu tienda.
Haz clic en Permisos (o "Change Permissions").
Establece los permisos a 644 para archivos y 755 para carpetas.

Si tu hosting usa un sistema Linux, puedes hacerlo también por FTP con un cliente como FileZilla.

[WARNING] No pongas permisos 777 en todos los archivos. Eso es un riesgo de seguridad grave. Usa siempre 644 y 755.

4. Aumenta el límite de memoria PHP

PrestaShop necesita memoria suficiente para funcionar. Si el límite es demasiado bajo, el servidor puede lanzar un error 500.

En cPanel:

Ve a Seleccionar versión de PHP (o "MultiPHP Manager").
Haz clic en Opciones o Switch to PHP Options.
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda los cambios.

También puedes editar el archivo php.ini si tienes acceso. Busca la línea memory_limit y cámbiala.

[INFO] Si no encuentras estas opciones en cPanel, contacta con tu proveedor de hosting. Algunos hostings compartidos tienen restricciones para modificar estos valores.

5. Cambia la versión de PHP

PrestaShop es sensible a la versión de PHP. Si tu hosting actualizó la versión de PHP y tu PrestaShop es antiguo, es probable que aparezca el error 500.

En cPanel:

Ve a Seleccionar versión de PHP.
Prueba con versiones como PHP 7.4, 8.0 u 8.1. No todas las versiones de PrestaShop son compatibles con PHP 8.2 o superior.
Guarda y recarga tu tienda.

Consulta la documentación oficial de PrestaShop para saber qué versión de PHP es compatible con tu versión de la tienda.

Solucionar error 500 en PrestaShop con Plesk

Plesk es otro panel de control muy popular, sobre todo en servidores VPS y dedicados. Los pasos son similares, pero con algunas diferencias.

1. Activa el modo de depuración en Plesk

El proceso es el mismo que en cPanel: editar el archivo config/defines.inc.php. La diferencia está en cómo accedes a los archivos.

Entra en Plesk y ve a Administrador de archivos (en el menú de tu dominio).
Navega hasta la carpeta raíz de tu tienda.
Localiza el archivo config/defines.inc.php y edítalo.
Cambia define('_PS_MODE_DEV_', false); a true.
Guarda los cambios.

Recarga tu tienda y observa el mensaje de error.

2. Regenera el .htaccess desde Plesk

En Plesk, el archivo .htaccess también puede ser la causa del problema.

Ve al Administrador de archivos de Plesk.
Muestra los archivos ocultos (hay un botón para ello).
Renombra .htaccess a .htaccess.bak.
Comprueba si el error desaparece.

Si desaparece, intenta regenerar el .htaccess desde el panel de administración de PrestaShop. Si no puedes, crea uno básico.

[TIP] Si tu hosting usa LiteSpeed o Nginx, el archivo .htaccess puede no ser suficiente. En ese caso, contacta con tu proveedor para ajustar la configuración del servidor.

3. Revisa los permisos en Plesk

Plesk también permite cambiar los permisos de archivos y carpetas.

En el Administrador de archivos, selecciona todos los archivos.
Haz clic en el botón Cambiar permisos.
Aplica 644 para archivos y 755 para carpetas.

4. Ajusta la configuración de PHP en Plesk

En Plesk, puedes modificar la configuración de PHP desde el panel de dominio.

Ve a tu dominio y haz clic en PHP Settings (Configuración de PHP).
Busca la opción memory_limit y auméntala a 256M o más.
También revisa max_execution_time y upload_max_filesize.

Guarda los cambios y prueba de nuevo.

5. Cambia la versión de PHP en Plesk

Plesk te permite cambiar fácilmente la versión de PHP.

Ve a tu dominio y haz clic en PHP Settings.
En la parte superior, selecciona la versión de PHP que quieras probar.
Guarda y recarga la tienda.

Otras soluciones avanzadas para el error 500

Si los pasos anteriores no resuelven el problema, prueba estas opciones.

Desactiva módulos recientes o conflictivos

Un módulo mal programado puede provocar un error 500. Para desactivarlo sin entrar al panel de administración:

Accede por FTP o al Administrador de archivos.
Ve a la carpeta modules.
Renombra la carpeta del módulo sospechoso (por ejemplo, ps_facebook a ps_facebook.bak).

Si el error desaparece, ese módulo era el problema. Puedes intentar actualizarlo o contactar con su desarrollador.

Comprueba los logs del servidor

Tanto cPanel como Plesk tienen registros de errores que pueden darte pistas.

En cPanel: busca la sección Errores o Error Logs.
En Plesk: ve a Logs en el menú de tu dominio.

Busca entradas que mencionen tu tienda y el error 500. Los mensajes tipo "PHP Fatal error" suelen ser muy reveladores.

Restaura una copia de seguridad anterior

Si nada funciona, la opción más rápida es restaurar una copia de seguridad de tu tienda de hace unos días. Asegúrate de que la copia sea anterior al momento en que empezó el error.

[WARNING] Restaurar una copia sobrescribirá todos los cambios que hayas hecho desde entonces. Si tenías pedidos o clientes nuevos, los perderás. Úsalo como último recurso.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 significa que mi tienda está hackeada?

No necesariamente. Es un error genérico del servidor. Pero si sospechas de un hackeo, revisa los archivos modificados recientemente y los logs de acceso.

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

Sí. Todos los pasos que te he explicado se pueden hacer desde el panel de control del hosting o por FTP. No necesitas entrar a PrestaShop para solucionarlo.

¿Cuánto tiempo se tarda en arreglar el error 500?

Depende de la causa. Si es solo el .htaccess, puedes tardar 10 minutos. Si es un módulo conflictivo, puede llevarte más tiempo. Ten paciencia y ve paso a paso.

¿Debo contactar con mi proveedor de hosting?

Si has probado todos los pasos y el error persiste, sí. Ellos pueden revisar los logs del servidor y darte información más detallada. A veces el problema está en la configuración del servidor y no en tu tienda.

Conclusión

El error 500 en PrestaShop puede ser frustrante, pero en la mayoría de los casos tiene solución siguiendo un orden lógico. Activa el modo de depuración, revisa el .htaccess, los permisos y la configuración de PHP. Si trabajas con calma y método, lo más probable es que lo resuelvas sin necesidad de contactar con un experto.

Recuerda: siempre haz una copia de seguridad antes de tocar nada. Y si tu hosting usa HestiaCP, ten en cuenta que en este artículo lo llamamos Syspanel, y el acceso se realiza a través del puerto 2106.

[TIP] Si el error 500 aparece después de una actualización de PrestaShop o de un módulo, la solución más rápida suele ser restaurar el archivo .htaccess o desactivar el módulo recién actualizado.

Espero que esta guía te haya sido de ayuda. Si tienes dudas, déjalas en los comentarios y te responderé encantado. ¡Buena suerte con tu tienda!