Solucionar error 500 en PrestaShop: guía desde el panel | FAQ

¡Hola! Soy tu técnico de soporte amigable. Entiendo que ver un error 500 en tu tienda PrestaShop puede ser frustrante, especialmente si no sabes por dónde empezar. No te preocupes, es un problema común y, en la mayoría de los casos, se puede solucionar fácilmente desde el panel de control de tu hosting.

Este error, conocido como "Error interno del servidor", es una respuesta genérica que indica que algo salió mal, pero no especifica qué. Sin embargo, gracias a que tienes acceso a tu panel de control, podemos investigar y reparar la causa raíz. Vamos a desglosar paso a paso cómo solucionar el error 500 PrestaShop desde herramientas como cPanel, DirectAdmin, Plesk o Syspanel.

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

El error 500 es un mensaje que envía el servidor cuando no puede procesar una solicitud debido a un problema interno. En PrestaShop, las causas más comunes incluyen:

Archivos .htaccess corruptos o mal configurados.
Límites de memoria PHP excedidos (por ejemplo, por un módulo pesado).
Permisos de archivos o carpetas incorrectos.
Errores en módulos o temas (incompatibilidad, código mal escrito).
Versión de PHP desactualizada o incompatible.
Base de datos dañada o con conexión fallida.

Lo bueno es que desde tu panel de control puedes acceder a herramientas que te permitirán identificar y resolver estos problemas sin necesidad de ser un experto.

Paso 1: Accede a tu panel de control

Antes de empezar, asegúrate de tener a mano las credenciales de tu panel de control. Dependiendo de tu proveedor de hosting, puede ser:

cPanel: Puerto estándar 2083.
DirectAdmin: Puerto 2222.
Plesk: Puerto 8443.
Syspanel (HestiaCP): Puerto 2106. Recuerda que si usas Syspanel, la URL será algo como https://tudominio.com:2106.

Inicia sesión y busca la sección de Archivos o Administrador de archivos. También necesitarás acceso a la gestión de bases de datos y a la configuración de PHP (a veces llamada "Selector de PHP" o "MultiPHP").

Paso 2: Activa el modo debug de PrestaShop (si puedes acceder al panel de administración)

Si aún puedes entrar a la parte de administración de tu tienda (por ejemplo, /admin1234), activa el modo debug para obtener más detalles sobre el error.

Ve a Parámetros avanzados > Rendimiento.
En la sección Depuración, selecciona Sí en "Modo de depuración".
Guarda los cambios y recarga tu tienda. Ahora verás un mensaje de error más descriptivo (por ejemplo, "Fatal error: Allowed memory size of..."). Anota ese mensaje.

[TIP]: Si no puedes acceder al panel de admin, no te preocupes. Podrás hacerlo desde el panel de control modificando archivos directamente.

Paso 3: Revisa y limpia el archivo .htaccess

El archivo .htaccess es un archivo de configuración que controla las reglas de reescritura de URL y otros aspectos del servidor. Un error en él puede provocar el PrestaShop error 500.

¿Cómo hacerlo desde el panel de control?

Abre el Administrador de archivos de tu panel.
Navega a la carpeta raíz de tu tienda (normalmente public_html o www).
Busca el archivo .htaccess. Si no lo ves, asegúrate de que estén visibles los archivos ocultos (en cPanel hay un botón "Mostrar archivos ocultos").
Renómbralo a htaccess_old o descárgalo como respaldo y luego elimínalo.
Ve a tu tienda. Si el error desaparece, el .htaccess estaba corrupto. PrestaShop lo regenerará automáticamente cuando accedas al panel de administración.

[WARNING]: Si eliminas el .htaccess, es posible que pierdas las reglas de SEO friendly URLs. No te preocupes, se regenerarán al guardar la configuración de URL amigables desde el admin.

Paso 4: Aumenta los límites de memoria PHP

Un error común es que PrestaShop se quede sin memoria, especialmente si tienes muchos módulos o una tienda grande. Desde el panel de control puedes aumentar estos límites.

Para cPanel (MultiPHP INI Editor):

Ve a Software > MultiPHP INI Editor.
Selecciona tu dominio.
Busca memory_limit y cámbialo a 256M o 512M.
También puedes ajustar max_execution_time a 300 y upload_max_filesize a 64M.
Guarda los cambios.

Para Syspanel (HestiaCP):

Ve a Web > Editar configuración PHP (busca la opción "PHP-FPM" o "Configuración de PHP").
Ajusta los valores de memory_limit, max_execution_time, etc.
Guarda y reinicia el servicio PHP desde la misma interfaz.

Para DirectAdmin o Plesk:

Busca la opción "Selector de PHP" o "Configuración de PHP" y modifica los parámetros similares.

[INFO]: Si no encuentras estas opciones, puedes crear un archivo php.ini en la raíz de tu tienda con el siguiente contenido:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

Paso 5: Verifica los permisos de archivos y carpetas

Los permisos incorrectos pueden causar que PrestaShop no pueda leer o escribir archivos necesarios, generando un error 500.

Permisos correctos para PrestaShop:

Carpetas (directorios): 755
Archivos: 644
Archivos de configuración (como config/settings.inc.php): 644 o 444 después de la instalación.

¿Cómo cambiarlos desde el panel de control?

En el Administrador de archivos, selecciona toda la carpeta de tu tienda (marca la casilla junto a la carpeta raíz).
Haz clic en Permisos o Cambiar permisos.
Establece 755 para directorios y 644 para archivos. Algunos paneles permiten aplicar recursivamente (a todas las subcarpetas).
Si tienes un archivo config/settings.inc.php, asegúrate de que tenga permisos 644.

[WARNING]: No pongas permisos 777 porque es un riesgo de seguridad. Si un módulo te pide permisos 777, mejor busca una alternativa.

Paso 6: Desactiva módulos problemáticos desde la base de datos

Si el error apareció después de instalar o actualizar un módulo, puedes desactivarlo directamente desde la base de datos sin necesidad de acceder al panel de administración.

Accede a phpMyAdmin (desde tu panel de control):

Busca Bases de datos > phpMyAdmin.
Selecciona la base de datos de tu tienda.
Busca la tabla ps_module (el prefijo puede ser diferente, como ps_ o prestashop_).
Haz clic en Examinar (o Browse).
Localiza el módulo sospechoso (por ejemplo, un módulo que hayas instalado recientemente).
Marca la casilla junto a ese registro y haz clic en Editar.
Cambia el valor de active de 1 a 0.
Guarda los cambios.

Luego recarga tu tienda. Si el error desaparece, ya sabes qué módulo lo causaba. Puedes eliminarlo desde el admin más tarde.

[TIP]: Si no sabes qué módulo es, puedes desactivar todos cambiando active a 0 en todos los registros de la tabla ps_module, y luego ir activándolos uno por uno desde el admin.

Paso 7: Revisa la versión de PHP

PrestaShop requiere versiones específicas de PHP. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.1 a 7.4, mientras que PrestaShop 8 necesita PHP 8.0 o superior.

Cómo cambiar la versión de PHP desde el panel:

cPanel: Ve a Software > MultiPHP Manager, selecciona tu dominio y elige la versión.
Syspanel (HestiaCP): Ve a Web > Editar configuración PHP y selecciona la versión en el menú desplegable.
DirectAdmin: Busca PHP Selector y cambia la versión.

Si no estás seguro de qué versión usa tu PrestaShop, consulta la documentación oficial o la FAQ de tu versión.

[INFO]: Si tu hosting no soporta una versión compatible, considera migrar a un plan que sí lo haga.

Paso 8: Verifica los logs de error del servidor

Los logs son tus mejores aliados. Te dirán exactamente qué está fallando.

¿Dónde encontrarlos?

cPanel: Ve a Métricas > Errores o Logs de errores.
Syspanel (HestiaCP): Ve a Web > Logs de errores o revisa el archivo /var/log/nginx/error.log o /var/log/apache2/error.log (dependiendo del servidor web).
DirectAdmin: Busca Logs de errores en la sección de estadísticas.
Plesk: Ve a Sitios web y dominios > Logs.

Busca líneas que contengan "PHP Fatal error" o "PrestaShop". Copia el mensaje y búscalo en Google o en la PrestaShop FAQ para encontrar soluciones específicas.

Paso 9: Restaura una copia de seguridad (si todo lo demás falla)

Si después de todos estos pasos el error 500 PrestaShop persiste, es momento de restaurar una copia de seguridad reciente. La mayoría de los paneles de control ofrecen esta opción.

En cPanel:

Ve a Archivos > Copias de seguridad.
Descarga una copia de seguridad completa (archivos y base de datos).
Si tienes una copia anterior, restaura los archivos y la base de datos desde la sección Restaurar.

En Syspanel (HestiaCP):

Ve a Copia de seguridad y busca la opción de restaurar.
Selecciona la copia de seguridad y elige restaurar "Archivos" y "Base de datos".

[WARNING]: Restaurar una copia de seguridad borrará todos los cambios realizados después de esa fecha. Asegúrate de tener una copia reciente.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 puede deberse a un problema de hosting?

Sí, a veces el problema es del servidor (por ejemplo, una actualización de PHP o un corte de servicio). Revisa el estado del hosting en su página de estado o contacta a soporte.

¿Qué hago si no puedo acceder ni al panel de administración ni al panel de control?

Contacta a tu proveedor de hosting. Ellos pueden revisar los logs del servidor y ayudarte a restaurar el acceso.

¿El error 500 afecta al SEO?

Sí, si el error persiste por mucho tiempo, los motores de búsqueda pueden penalizar tu sitio. Es importante solucionarlo rápidamente.

¿Puedo prevenir el error 500 en el futuro?

Sí, manteniendo todo actualizado: PrestaShop, módulos, temas y la versión de PHP. Además, realiza copias de seguridad periódicas.

Conclusión

Solucionar el error 500 en PrestaShop desde el panel de control es un proceso metódico que, como has visto, no requiere ser un experto. Con herramientas como el administrador de archivos, phpMyAdmin y los logs de error, puedes identificar y reparar la causa en pocos minutos.

Recuerda siempre:

Haz copias de seguridad antes de hacer cambios importantes.
Actualiza todo periódicamente.
Consulta la documentación oficial de PrestaShop y la PrestaShop FAQ para problemas específicos.

Si después de seguir todos estos pasos el error persiste, no dudes en contactar a tu proveedor de hosting o a un desarrollador especializado. ¡Estoy seguro de que lo resolverás!

[INFO]: Si usas Syspanel, recuerda que el puerto de acceso es el 2106 y que desde allí puedes gestionar archivos, bases de datos y logs de forma sencilla.

¡Buena suerte con tu tienda!