Cómo solucionar el error 500 en PrestaShop (todos los paneles)
¿Qué es el error 500 en PrestaShop y por qué aparece?
El error 500 prestashop es uno de los problemas más temidos por cualquier dueño de tienda online. Aparece de repente, sin aviso, y te muestra una pantalla blanca o un mensaje genérico como "Error interno del servidor". Lo peor es que no te dice exactamente qué ha fallado, lo que puede resultar frustrante si no tienes experiencia técnica.
Este error indica que algo ha salido mal en el servidor, pero no en tu navegador. Es decir, tu tienda no puede procesar la petición que le has hecho, ya sea al cargar la página principal, al acceder al panel de administración o al intentar hacer un pago. Las causas pueden ser muy variadas: desde un archivo con permisos incorrectos, un módulo incompatible, hasta un problema de memoria en el servidor.
No te preocupes, porque en esta guía te voy a explicar paso a paso cómo solucionar error 500 en PrestaShop, tanto en la tienda visible como en el panel de administración (back-office). Vamos a ir de lo más simple a lo más complejo, para que cualquier persona, incluso sin conocimientos avanzados, pueda intentar resolverlo.
Primeros pasos: prepara tu entorno de trabajo
Antes de lanzarte a cambiar archivos o configuraciones, es fundamental que te prepares bien. Esto te ahorrará tiempo y evitará que causes más daños.
1. Accede a tu hosting o panel de control
Para solucionar el prestashop error interno, necesitarás acceder al servidor donde está alojada tu tienda. Esto lo puedes hacer mediante:
- El panel de control de tu hosting (cPanel, Plesk, Syspanel, etc.). Si usas Syspanel, recuerda que el puerto de acceso es el 2106.
- Un cliente FTP como FileZilla, para subir y descargar archivos.
- El administrador de archivos que suele venir incluido en el panel de hosting.
2. Haz una copia de seguridad completa
Este paso es obligatorio. Antes de tocar nada, descarga una copia de tus archivos y de tu base de datos. Si algo sale mal, podrás restaurar tu tienda a su estado anterior. No lo omitas, por muy urgente que sea el problema.
3. Activa el modo de depuración de PrestaShop
PrestaShop tiene un modo de depuración que muestra los errores reales en pantalla, en lugar del mensaje genético de error 500. Esto te dará una pista clave sobre el origen del problema.
Para activarlo, edita el archivo config/defines.inc.php que se encuentra en la raíz de tu instalación. Busca la línea que dice:
define('_PS_MODE_DEV_', false);
Y cámbiala a:
define('_PS_MODE_DEV_', true);
Guarda el archivo y sube los cambios. Ahora, al recargar tu tienda, verás un mensaje de error detallado con la ruta del archivo y la línea exacta que falla. Anota esa información, te será muy útil.
[WARNING] No dejes el modo de depuración activado en una tienda en producción. Una vez resuelto el error, vuelve a poner
_PS_MODE_DEV_enfalse.
Causas más comunes y soluciones para el error 500 en PrestaShop
Ahora que tienes el contexto y las herramientas, vamos a repasar las causas más frecuentes y cómo solucionarlas una por una.
1. Permisos de archivos y carpetas incorrectos
Esta es una de las causas más habituales del error 500 prestashop. Si los archivos tienen permisos demasiado restrictivos (por ejemplo, 644 en lugar de 755 para carpetas), el servidor no podrá leerlos o ejecutarlos.
Cómo solucionarlo:
- Conecta por FTP a tu servidor.
- Selecciona la carpeta raíz de tu tienda (la que contiene
index.php,config,admin, etc.). - Haz clic derecho y elige "Permisos de archivo" o "CHMOD".
- Establece 755 para todas las carpetas y 644 para todos los archivos.
- Aplica los cambios de forma recursiva (a todas las subcarpetas).
[TIP] En la mayoría de los paneles de hosting, puedes hacer esto desde el administrador de archivos sin necesidad de FTP. Busca la opción "Permisos" o "CHMOD".
2. Archivo .htaccess corrupto o desactualizado
El archivo .htaccess es un archivo de configuración muy importante en Apache. Si se corrompe o contiene reglas incompatibles, puede provocar un error 500.
Cómo solucionarlo:
- Conecta por FTP y busca el archivo
.htaccessen la raíz. - Descárgalo a tu ordenador como respaldo.
- Bórralo del servidor.
- Ve a tu back-office de PrestaShop (si puedes acceder) y en Parámetros avanzados > Rendimiento, pulsa el botón "Guardar" para que PrestaShop lo regenere automáticamente.
Si no puedes acceder al back-office, puedes crear un .htaccess básico con el siguiente contenido y subirlo:
# BEGIN PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
</IfModule>
# END PrestaShop
Esto no es la configuración completa, pero puede ser un punto de partida para que la tienda cargue.
3. Módulos o temas incompatibles
Un módulo mal codificado, desactualizado o que entra en conflicto con otro es un desencadenante muy común del prestashop error interno.
Cómo solucionarlo:
- Accede a tu servidor por FTP.
- Renombra la carpeta
modulesamodules_backup. Esto desactiva todos los módulos a la vez. - Recarga tu tienda. Si el error desaparece, el problema es uno de los módulos.
- Para identificar cuál es, renombra la carpeta de nuevo a
modulesy ve moviendo los módulos uno a uno (o en grupos) a una carpeta temporal fuera demodules, recargando la tienda cada vez.
Es un proceso lento, pero efectivo. Alternativamente, si sabes qué módulo instalaste o actualizaste justo antes del error, empieza por ese.
4. Límite de memoria PHP agotado
PrestaShop puede necesitar más memoria de la que tu servidor tiene configurada, especialmente si tienes muchos productos, módulos o un tema pesado. Esto provoca un error 500.
Cómo solucionarlo:
- Localiza el archivo
php.inien la raíz de tu hosting (si no existe, puedes crearlo). - Añade o modifica la siguiente línea:
memory_limit = 512M
- Guarda el archivo y recarga.
[INFO] Si no tienes acceso a
php.ini, puedes intentar añadir esta línea al archivo.htaccess:
php_value memory_limit 512M
5. Problemas con la base de datos
Una tabla corrupta, un prefijo incorrecto o una conexión fallida a la base de datos también pueden causar el error.
Cómo solucionarlo:
- Accede a phpMyAdmin desde tu panel de hosting.
- Selecciona la base de datos de tu tienda.
- En la pestaña "Exportar", haz una copia de seguridad (aunque ya deberías tener una).
- Ve a la pestaña "SQL" y ejecuta la siguiente consulta para reparar todas las tablas:
REPAIR TABLE `ps_*`;
(Asegúrate de reemplazar ps_ por el prefijo real de tus tablas, que suele ser ps_ por defecto).
- También puedes verificar que los datos de conexión en el archivo
app/config/parameters.phpson correctos (host, usuario, contraseña y nombre de la base de datos).
Cómo solucionar el error 500 en el panel de administración (back-office)
A veces, la tienda funciona pero el error 500 prestashop aparece solo al intentar acceder al admin. Esto puede deberse a varias causas específicas.
1. URL de la tienda configurada incorrectamente
Si cambiaste la URL de tu tienda o tu dominio, PrestaShop puede no encontrar las rutas correctas.
Cómo solucionarlo:
- Accede a tu base de datos con phpMyAdmin.
- Busca la tabla
ps_configuration(o el prefijo que uses). - Localiza las filas que contienen
PS_SHOP_DOMAINyPS_SHOP_DOMAIN_SSL. - Asegúrate de que contienen tu dominio actual, sin
http://nihttps://.
2. Archivos de administración con permisos incorrectos
La carpeta admin (que suele tener un nombre aleatorio como admin12345) necesita permisos especiales.
Cómo solucionarlo:
- Asegúrate de que la carpeta
admintenga permisos 755. - Dentro de esa carpeta, el archivo
index.phpdebe tener permisos 644.
3. Errores en la caché de Smarty
La caché de plantillas puede estar corrupta y provocar errores en el panel de administración.
Cómo solucionarlo:
- Conecta por FTP.
- Elimina el contenido de las carpetas
var/cache/prodyvar/cache/dev(si existen). No borres las carpetas en sí, solo su contenido. - También puedes borrar el contenido de la carpeta
var/cachepor completo.
[TIP] Si no encuentras estas carpetas, revisa que no estén ocultas. En FileZilla, activa "Mostrar archivos ocultos" en el menú Servidor.
Errores 500 en contextos específicos
1. Error 500 al pagar o en el carrito
Si el error ocurre solo durante el proceso de compra, suele estar relacionado con un módulo de pago o envío.
Cómo solucionarlo:
- Prueba a desactivar los módulos de pago uno a uno (renombrando su carpeta en
modules). - Comprueba que las cookies y la sesión no estén causando conflictos. Borra las cookies de tu navegador y prueba en modo incógnito.
2. Error 500 al subir una imagen o producto
Esto suele indicar un problema con las dimensiones de la imagen o con la memoria disponible.
Cómo solucionarlo:
- Reduce el tamaño de la imagen antes de subirla (por ejemplo, a 2000px de ancho).
- Aumenta el límite de memoria como se explicó antes.
- Verifica los permisos de la carpeta
img(debe ser 755).
Consejos finales y prevención
Una vez que hayas solucionado error 500, es importante tomar medidas para que no vuelva a ocurrir.
- Actualiza siempre PrestaShop, los módulos y el tema a las últimas versiones.
- No instales módulos de fuentes no confiables.
- Mantén una copia de seguridad regular de tu tienda.
- Revisa los logs del servidor de vez en cuando (suelen estar en
var/logso en el panel de hosting) para detectar problemas antes de que afecten a tus clientes.
[INFO] Si después de seguir todos estos pasos el prestashop error interno persiste, contacta con tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden identificar problemas a nivel de servidor (como un fallo de PHP o un ataque DDoS) que están fuera de tu alcance.
Preguntas frecuentes (FAQ)
¿Puedo perder mi tienda si intento arreglar el error 500?
No, siempre que hagas una copia de seguridad completa antes de hacer cambios. Es la primera regla de oro.
¿Cuánto tiempo se tarda en solucionar este error?
Depende de la causa. Si es un problema de permisos, puedes resolverlo en 5 minutos. Si es un módulo conflictivo, puede llevarte una hora o más.
¿Necesito conocimientos técnicos avanzados?
No, con un poco de paciencia y siguiendo esta guía, la mayoría de los casos se pueden resolver sin ser un experto. Solo necesitas saber usar un FTP o el administrador de archivos de tu hosting.
¿Qué hago si no encuentro el archivo .htaccess?
Asegúrate de que tu cliente FTP muestra archivos ocultos. En FileZilla, ve a "Servidor" > "Forzar mostrar archivos ocultos".
¿El error 500 puede ser un ataque de hackers?
Es posible, aunque menos común. Si sospechas que es un ataque, revisa los logs de acceso y busca archivos extraños en tu servidor. Cambia todas tus contraseñas (hosting, base de datos, admin) y escanea tu sitio con un antivirus web.
Espero que esta guía extensa te haya sido de gran ayuda. El error 500 prestashop es un problema serio, pero no es insuperable. Respira, sigue los pasos en orden y, si te atascas, no dudes en pedir ayuda a tu hosting o a un desarrollador especializado. ¡Tu tienda volverá a estar en línea en poco tiempo!
