Solución de errores comunes en PrestaShop: 500 Internal Server

¿Te ha pasado? Estás trabajando tranquilamente en tu tienda online, añadiendo productos o modificando una plantilla, y de repente… pantalla en blanco. O peor aún, un mensaje escueto y frío: Error 500 Internal Server. No te preocupes, es uno de los errores más comunes en PrestaShop y, por suerte, también uno de los que tiene más solución errores a tu alcance.

En este artículo, vamos a desglosar paso a paso cómo identificar y solucionar el temido Internal Server Error en PrestaShop. No necesitas ser un experto en Linux y SysAdmin; te guiaremos con un lenguaje claro y ejemplos prácticos. Al final, tendrás las herramientas para que tu tienda vuelva a funcionar en pocos minutos.

[TIP] Antes de empezar, si tienes acceso a un panel de control como Syspanel (accesible por el puerto 2106, por ejemplo: tudominio.com:2106), muchas de estas acciones se pueden realizar desde la interfaz gráfica, lo que facilita enormemente el proceso.

---

¿Qué es exactamente el error 500 Internal Server?

Imagina que tu servidor es un restaurante. Cuando un cliente pide un plato (tu tienda PrestaShop), el cocinero (el servidor web) recibe la orden. Si el cocinero se encuentra con un problema (una receta mal escrita, un ingrediente caducado, o una herramienta rota), no puede servir el plato y, en lugar de dar una explicación detallada, simplemente dice: "Lo siento, error interno, no puedo prepararlo". Eso es un error 500.

En términos técnicos, significa que el servidor encontró una condición inesperada que le impidió completar la solicitud. Las causas pueden ser muy variadas, desde un archivo .htaccess corrupto hasta un módulo de PrestaShop mal configurado.

Síntomas comunes del error 500 en PrestaShop

• Pantalla completamente en blanco (White Screen of Death).
• Mensaje "Error 500 Internal Server Error" en el navegador.
• La tienda carga a medias, mostrando solo la cabecera o el pie de página.
• El error aparece solo en algunas páginas (por ejemplo, al ir al carrito o al panel de administración).

---

Causas principales y sus soluciones paso a paso

Vamos a ir de lo más simple a lo más complejo. No te saltes pasos, ya que la solución a menudo es más sencilla de lo que parece.

1. Archivo .htaccess corrupto o mal configurado

El .htaccess es un archivo de configuración que le dice al servidor web (Apache) cómo comportarse. Un error aquí es una de las causas más frecuentes del error 500.

Solución:

1. Accede a tu servidor mediante FTP o al administrador de archivos de Syspanel (puerto 2106).
2. Localiza el archivo .htaccess en la raíz de tu instalación de PrestaShop (normalmente en public_html/ o www/).
3. Renómbralo a algo como .htaccess_backup o .htaccess.old. Esto lo desactivará temporalmente.
4. Vuelve a cargar tu tienda. Si el error desaparece, el problema era el .htaccess.
5. Para regenerar uno nuevo y limpio:
   • Ve al panel de administración de PrestaShop.
   • Ve a Configuración avanzada > Rendimiento.
   • En la sección "URLs amigables", haz clic en "Guardar". Esto forzará a PrestaShop a crear un nuevo .htaccess con la configuración correcta.

[WARNING] Si no puedes acceder al panel de administración porque también te da error 500, tendrás que crear el .htaccess manualmente. Puedes copiar el contenido de un .htaccess de una instalación limpia de PrestaShop o, como último recurso, dejarlo vacío (aunque perderás las URLs amigables temporalmente).

2. Límite de memoria PHP excedido (memory_limit)

PrestaShop es un sistema exigente. Si tu tienda tiene muchos productos, módulos pesados o mucho tráfico, puede superar el límite de memoria PHP que tiene asignado tu servidor.

Solución:

1. Aumenta el límite de memoria PHP. Esto se hace modificando el archivo php.ini o el archivo config/defines.inc.php de PrestaShop.
2. Opción 1 (recomendada): Edita el archivo config/defines.inc.php en la raíz de tu instalación. Busca la línea:

   define('_PS_MEMORY_LIMIT_', '128M');
   

   Cámbiala a 256M o incluso 512M si tu servidor lo permite.

   define('_PS_MEMORY_LIMIT_', '256M');
   

3. Opción 2 (si tienes acceso al php.ini): Busca la línea:

   memory_limit = 128M
   

   Cámbiala a 256M o 512M. Si no tienes acceso al php.ini, puedes crear un archivo php.ini en la raíz de tu tienda con esa línea.
4. Opción 3 (a través de Syspanel): En Syspanel (puerto 2106), dentro de la sección de configuración de tu sitio web, suele haber una opción para "Ajustes de PHP" o "PHP Settings". Ahí podrás modificar el memory_limit de forma gráfica.
5. Guarda los cambios y recarga la tienda.

3. Módulo o tema de PrestaShop defectuoso

Un módulo o tema mal codificado, desactualizado o que entra en conflicto con otro puede provocar un error 500. Es muy común después de actualizar PrestaShop o instalar un nuevo complemento.

Solución:

1. Identifica el culpable. Piensa si el error empezó justo después de instalar o actualizar un módulo o tema.
2. Desactiva módulos sospechosos. Si tienes acceso al panel de administración:
   • Ve a Módulos > Gestor de Módulos.
   • Localiza los módulos instalados recientemente o que sospeches.
   • Haz clic en "Desactivar".
3. Si no tienes acceso al panel de administración (error 500 también ahí):
   • Accede a tu servidor por FTP o al administrador de archivos de Syspanel.
   • Ve a la carpeta /modules/.
   • Renombra la carpeta del módulo problemático añadiendo _old al final. Por ejemplo, si el módulo se llama mimodulo, renómbralo a mimodulo_old. Esto lo desactivará automáticamente.
4. Cambia temporalmente al tema por defecto. Ve a la carpeta /themes/ y renombra la carpeta de tu tema actual (ej. tupersonalizado a tupersonalizado_old). PrestaShop usará el tema por defecto (normalmente classic). Si el error desaparece, el problema es tu tema.

[INFO] Si después de desactivar todo el error persiste, puede que el problema sea un módulo del núcleo. En ese caso, una reinstalación limpia de los archivos de PrestaShop (sin borrar la base de datos) suele ser la solución definitiva.

4. Archivos con permisos incorrectos

Los archivos y carpetas de tu servidor tienen permisos que determinan quién puede leerlos, escribirlos o ejecutarlos. Un permiso incorrecto (por ejemplo, una carpeta con permisos 777 cuando debería ser 755) puede causar un error 500.

Solución:

1. Conéctate a tu servidor por FTP o al administrador de archivos de Syspanel.
2. Asegúrate de que los permisos sean los correctos:
   • Carpetas: 755 (rwxr-xr-x)
   • Archivos: 644 (rw-r--r--)
   • Archivos de configuración (config/settings.inc.php): 644 o 640.
   • Carpetas cache/, log/, img/, upload/, download/: 755.
3. Cómo cambiarlos: En la mayoría de los clientes FTP, haz clic derecho sobre el archivo/carpeta y selecciona "Permisos" o "CHMOD". En Syspanel, suele haber una opción similar en el administrador de archivos.
4. Herramienta automática: Si tienes acceso a la línea de comandos (SSH), puedes usar el siguiente comando para arreglar todos los permisos de una vez (desde la raíz de tu instalación de PrestaShop):

   find . -type f -exec chmod 644 {} \;
   find . -type d -exec chmod 755 {} \;
   

   [WARNING] Ten cuidado con el comando chmod -R 777 *. Nunca lo uses, ya que expone tu tienda a graves problemas de seguridad. Sigue siempre la regla 755 para carpetas y 644 para archivos.

5. Error en la base de datos

Aunque menos común, una tabla corrupta o un registro mal formado en la base de datos también puede desencadenar un Internal Server Error.

Solución:

1. Accede a phpMyAdmin. Puedes hacerlo desde Syspanel (puerto 2106) en la sección de bases de datos.
2. Repara las tablas. Selecciona todas las tablas de tu base de datos de PrestaShop y, en el menú desplegable "Con seleccionados", elige "Reparar tabla".
3. Optimiza las tablas. Después de reparar, repite el proceso pero elige "Optimizar tabla". Esto compacta y limpia la base de datos.
4. Si el problema persiste, restaura una copia de seguridad reciente de la base de datos. Si no tienes una, contacta con tu proveedor de hosting.

---

Preguntas Frecuentes (FAQ) sobre el error 500 en PrestaShop

¿Puedo solucionar el error 500 sin perder datos?

Sí, en la gran mayoría de los casos. Las soluciones que te hemos dado (modificar .htaccess, aumentar memoria, desactivar módulos) no borran ni productos, ni clientes, ni pedidos. Los datos se almacenan en la base de datos, que no se toca en estos procesos.

¿Y si después de todo sigue el error 500?

Si has probado todos los pasos anteriores y el Internal Server Error persiste, es posible que el problema sea a nivel de servidor (configuración de Apache, Nginx, PHP, etc.). En ese caso, deberías contactar con el soporte técnico de tu hosting. Diles que ya has verificado .htaccess, permisos, memoria y módulos. Así ellos sabrán que el problema está en su infraestructura.

¿Cómo puedo ver el log de errores de PrestaShop para saber más?

Los logs son tus mejores amigos. Puedes encontrarlos en:

• Carpeta /log/ de tu instalación de PrestaShop. Busca archivos como error.log o fatal.log.
• Desde Syspanel (puerto 2106), suele haber una sección de "Logs" o "Registros de errores" donde puedes ver los errores del servidor web.
• Accediendo por SSH a tu servidor y ejecutando tail -f /var/log/apache2/error.log (o la ruta de tu servidor). Esto te mostrará los errores en tiempo real.

¿El error 500 afecta al SEO de mi tienda?

Sí, y mucho. Si el error se mantiene durante horas o días, los motores de búsqueda (Google, Bing) pueden interpretar que tu sitio no está disponible y empezar a degradar tu posicionamiento. Por eso es tan importante solucionarlo rápidamente. Además, una mala experiencia de usuario (páginas que no cargan) aumenta la tasa de rebote, otro factor negativo para el SEO.

---

Conclusión: No temas al error 500

El error 500 Internal Server en PrestaShop es como un dolor de cabeza: molesto, pero generalmente fácil de tratar con los pasos adecuados. Hemos visto que las causas más comunes son un .htaccess corrupto, falta de memoria PHP, módulos o temas problemáticos, y permisos incorrectos.

Recuerda siempre:

1. Empieza por lo más simple: renombrar el .htaccess.
2. Aumenta la memoria PHP si tu tienda es grande o tiene muchos módulos.
3. Desactiva módulos y temas para aislar el problema.
4. Revisa los logs para obtener pistas precisas.
5. Si todo falla, contacta a tu hosting y diles que ya hiciste las comprobaciones básicas.

Con esta guía, ya tienes un plan de acción claro. La próxima vez que veas ese temido mensaje, no entrarás en pánico, sino que sonreirás sabiendo que tienes la solución errores en tus manos. ¡Manos a la obra y a recuperar tu tienda!