Solucionar errores 500 y 404 en PrestaShop (DirectAdmin)

¿Tu tienda PrestaShop muestra un molesto error 500 o un frustrante error 404? No te preocupes, son problemas comunes que tienen solución. En esta guía te explicaré paso a paso cómo identificar y solucionar estos errores cuando tu tienda está alojada en un servidor con panel de control DirectAdmin. Tanto si eres nuevo en la administración de servidores como si ya tienes algo de experiencia, aquí encontrarás las respuestas que necesitas.

¿Qué significan realmente el error 500 y el error 404?

Antes de lanzarnos a las soluciones, es importante entender qué está pasando. El error 500 (Internal Server Error) es un mensaje genérico que indica que algo salió mal en el servidor, pero no especifica qué. Puede deberse a un archivo .htaccess corrupto, un módulo de PrestaShop defectuoso, problemas de permisos o incluso un límite de memoria excedido. Por otro lado, el error 404 (Not Found) significa que la página que buscas no existe en el servidor. En PrestaShop, esto suele ocurrir cuando se rompen las reglas de reescritura de URLs (los famosos "amigables") o cuando se ha movido o eliminado un producto o categoría sin actualizar correctamente la base de datos.

Causas comunes del error 500 en PrestaShop con DirectAdmin

El error 500 en PrestaShop puede aparecer de repente, incluso sin haber tocado nada. Estas son las causas más frecuentes:

1. Archivo .htaccess dañado o incorrecto

PrestaShop genera automáticamente un archivo .htaccess en la raíz de tu tienda. Si este archivo se corrompe (por ejemplo, al instalar un módulo o al hacer una copia de seguridad manual), el servidor no sabrá cómo interpretar las reglas y lanzará un error 500.

2. Módulos o temas incompatibles

Un módulo mal programado o un tema que no respeta los estándares de PrestaShop puede generar conflictos internos. A veces, al activar un módulo nuevo, el servidor se bloquea y muestra el error 500.

3. Límite de memoria PHP excedido

Si tu tienda tiene muchos productos, tráfico elevado o módulos pesados, puede superar el límite de memoria asignado por defecto en DirectAdmin. Esto provoca que el servidor no pueda ejecutar las peticiones y responda con un error 500.

4. Permisos de archivos incorrectos

En DirectAdmin, los archivos deben tener permisos 644 y las carpetas 755. Si accidentalmente cambiaste permisos (por ejemplo, al subir archivos por FTP con un cliente mal configurado), el servidor no podrá leer o escribir correctamente.

5. Error en la configuración de PHP

DirectAdmin permite cambiar la versión de PHP o ajustar parámetros como memory_limit o max_execution_time. Si seleccionas una versión incompatible con PrestaShop (por ejemplo, PHP 8.3 con un PrestaShop 1.6), obtendrás un error 500.

Causas comunes del error 404 en PrestaShop con DirectAdmin

El error 404 en PrestaShop suele estar relacionado con la gestión de URLs. Las causas principales son:

1. URLs amigables desactivadas o mal configuradas

PrestaShop tiene una opción para activar URLs amigables (por ejemplo, /zapatos-rojos en lugar de ?id_product=123). Si esta opción está activada pero el archivo .htaccess no se ha regenerado correctamente, todas las páginas darán error 404.

2. Productos o categorías eliminados sin redirección

Si eliminas un producto o categoría y no configuras una redirección 301, los enlaces antiguos (indexados por Google o guardados en favoritos) llevarán a un error 404.

3. Error en el archivo .htaccess (reglas de reescritura)

Al igual que con el error 500, un .htaccess dañado puede no contener las reglas necesarias para que el servidor reescriba las URLs. En lugar de un error 500, puede mostrar un 404 si las reglas están incompletas.

4. Problemas con el módulo de SEO o redirecciones

Algunos módulos de SEO (como los que gestionan redirecciones masivas) pueden generar conflictos y provocar que URLs válidas devuelvan un 404.

Soluciones paso a paso para el error 500 en PrestaShop (DirectAdmin)

Vamos a resolver el error 500 con métodos ordenados, del más simple al más complejo.

Solución 1: Regenerar el archivo .htaccess

Esta es la primera acción que debes probar, ya que es rápida y no requiere conocimientos avanzados.

Accede a tu panel de DirectAdmin. Normalmente la URL es https://tudominio.com:2222.
Ve a "Administrador de archivos" (File Manager) y navega hasta la carpeta donde está instalado PrestaShop (generalmente public_html o domains/tudominio.com/public_html).
Busca el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos" en la configuración del administrador de archivos.
Renombra el archivo .htaccess a .htaccess_old (esto lo desactivará temporalmente).
Ve al back office de PrestaShop (agregando /admin a tu dominio, por ejemplo tudominio.com/admin).
Ve a "Configuración de la tienda" > "Tráfico y SEO" > "SEO y URLs".
Sin cambiar nada, haz clic en "Guardar". Esto regenerará automáticamente el archivo .htaccess.
Vuelve a tu tienda y comprueba si el error 500 ha desaparecido.

[TIP] Si no puedes acceder al back office, puedes forzar la regeneración desde el archivo config/defines.inc.php. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a true. Luego visita cualquier página de tu tienda; verás un mensaje de error detallado. Después de solucionar, vuelve a ponerlo en false.

Solución 2: Desactivar módulos problemáticos desde la base de datos

Si el error 500 te impide acceder al back office, puedes desactivar módulos directamente desde la base de datos usando phpMyAdmin (incluido en DirectAdmin).

En DirectAdmin, busca el icono de "phpMyAdmin" (suele estar en la sección "Base de Datos" o "Advanced Features").
Selecciona la base de datos de tu PrestaShop (la que configuraste durante la instalación).
Haz clic en la tabla ps_module (el prefijo puede ser diferente si lo cambiaste; por defecto es ps_).
Busca los módulos que hayas instalado recientemente. Puedes ordenar por date_add para ver los más nuevos.
Para desactivar un módulo, cambia su estado: en la tabla ps_module, busca la columna active y pon 0 (cero) en los módulos sospechosos.
También puedes eliminar módulos de la tabla ps_module si estás seguro de que son la causa.
Después de los cambios, vacía la caché de PrestaShop: en el back office, ve a "Parámetros avanzados" > "Rendimiento" y haz clic en "Limpiar caché".

[WARNING] Ten cuidado al modificar la base de datos. Siempre haz una copia de seguridad antes de tocar nada. Un error aquí puede dejar tu tienda inservible.

Solución 3: Aumentar el límite de memoria PHP

Si el error 500 aparece en páginas con muchos productos o al cargar el back office, probablemente necesites más memoria.

En DirectAdmin, busca la opción "Selector de PHP" o "PHP Settings" (puede variar según la versión).
Selecciona la versión de PHP que estés usando (por ejemplo, 8.0 o 8.1).
Busca el parámetro memory_limit y cámbialo a 256M o 512M. También puedes ajustar max_execution_time a 300.
Guarda los cambios y espera unos segundos a que se apliquen.
Vuelve a cargar tu tienda.

[INFO] Si no encuentras el selector de PHP, 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

Solución 4: Verificar permisos de archivos y carpetas

Los permisos incorrectos son una causa clásica de error 500. En DirectAdmin, puedes corregirlos fácilmente.

Ve a "Administrador de archivos" y selecciona toda la carpeta de tu tienda (por ejemplo, public_html).
Haz clic en "Cambiar permisos" (o "Permissions").
Marca las opciones:
- Archivos: 644 (lectura y escritura para el propietario, solo lectura para grupo y otros).
- Carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y otros).
Aplica los cambios. Esto puede tomar unos segundos si hay muchos archivos.

[WARNING] No pongas permisos 777 en archivos o carpetas, ya que supone un grave riesgo de seguridad. Solo usa 755 para carpetas y 644 para archivos.

Soluciones paso a paso para el error 404 en PrestaShop (DirectAdmin)

El error 404 suele ser más fácil de arreglar que el 500. Sigue estos pasos.

Solución 1: Regenerar el archivo .htaccess (para URLs amigables)

Al igual que con el error 500, regenerar el .htaccess puede solucionar el 404 si el problema está en las reglas de reescritura.

Sigue los pasos de la "Solución 1" del error 500 (renombrar .htaccess y guardar en SEO y URLs).
Después de regenerar, verifica que las URLs amigables estén activadas: en "SEO y URLs", asegúrate de que la opción "URLs amigables" esté en "Sí".
Guarda de nuevo y prueba una página de producto o categoría.

Solución 2: Verificar la configuración de URLs amigables en DirectAdmin

A veces, DirectAdmin necesita un pequeño ajuste para que las reglas de reescritura funcionen correctamente.

En DirectAdmin, ve a "Administrador de dominios" o "Domain Setup".
Busca tu dominio y haz clic en "Modificar".
Asegúrate de que la opción "Reescritura de URLs" (o "URL rewriting") esté activada. Si no lo está, actívala y guarda.
También puedes verificar que el módulo mod_rewrite de Apache esté habilitado. En DirectAdmin, esto se gestiona desde "Apache Configuration" > "Custom HTTPD Config". Si no ves la opción, contacta con tu proveedor de hosting.

Solución 3: Crear redirecciones 301 para páginas eliminadas

Si eliminaste productos o categorías, debes redirigir las URLs antiguas a las nuevas para evitar el error 404.

En el back office de PrestaShop, ve a "Configuración de la tienda" > "Tráfico y SEO" > "Redirecciones y 404".
Haz clic en "Añadir nueva redirección".
Introduce la URL antigua (por ejemplo, /zapatos-viejos) y la URL nueva (por ejemplo, /zapatos-nuevos).
Selecciona "301 Movido permanentemente" y guarda.
Repite para cada página que haya cambiado.

[TIP] Si tienes muchas URLs, puedes usar un módulo de redirecciones masivas o editar directamente el archivo .htaccess añadiendo líneas como:
Redirect 301 /zapatos-viejos https://tudominio.com/zapatos-nuevos

Solución 4: Comprobar el módulo de SEO y limpiar caché

A veces, el módulo de SEO (como el de "SEO Expert" o "Redirection") puede estar causando conflictos. Desactívalo temporalmente:

Ve a "Módulos" > "Gestor de módulos".
Busca el módulo de SEO o redirecciones que tengas instalado.
Desactívalo y comprueba si el error 404 desaparece.
Si es así, contacta al desarrollador del módulo para una actualización o busca una alternativa.

Preguntas frecuentes (FAQ) sobre errores 500 y 404 en PrestaShop con DirectAdmin

¿Por qué aparece el error 500 después de instalar un módulo?

Los módulos mal codificados o incompatibles con tu versión de PrestaShop pueden generar conflictos. La solución más rápida es desactivar el módulo desde la base de datos (como vimos en la Solución 2 del error 500) o desde el back office si puedes acceder.

¿El error 404 puede deberse a un problema de caché?

Sí, la caché de PrestaShop o del servidor puede almacenar URLs obsoletas. Limpia la caché desde "Parámetros avanzados" > "Rendimiento" y también desde DirectAdmin (en "Administrador de archivos", elimina la carpeta cache dentro de public_html).

¿Cómo sé si el error es por el archivo .htaccess?

Si renombras el archivo .htaccess a .htaccess_old y el error 500 o 404 desaparece, entonces el problema está en ese archivo. Regenerarlo como explicamos suele ser suficiente.

¿Puedo usar Syspanel (HestiaCP) en lugar de DirectAdmin?

Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el proceso es similar pero la interfaz cambia. En Syspanel, accedes por el puerto 2106 (por ejemplo, https://tudominio.com:2106). Las opciones de administrador de archivos, phpMyAdmin y configuración de PHP se encuentran en el panel izquierdo. Las soluciones aquí descritas son aplicables, solo cambia la ruta de acceso.

¿Qué hago si ninguna solución funciona?

Si después de probar todos los pasos el error persiste, puede ser un problema del servidor (como falta de recursos o configuración de Apache). Contacta a tu proveedor de hosting y diles que tienes un error 500 o 404 en PrestaShop. Proporciona los pasos que ya intentaste para que puedan ayudarte más rápido.

Consejos finales para prevenir estos errores

La mejor forma de lidiar con los errores 500 y 404 es prevenirlos. Aquí tienes algunas buenas prácticas:

Siempre haz copias de seguridad antes de instalar módulos, temas o hacer cambios en la configuración. En DirectAdmin, puedes usar la opción "Backup" para crear una copia completa de tu tienda.
Mantén PrestaShop y todos los módulos actualizados. Las versiones antiguas son más propensas a errores.
Usa un entorno de pruebas (staging) para probar cambios antes de aplicarlos en tu tienda real. Muchos hosting ofrecen esta opción.
Configura alertas de errores en DirectAdmin para que te notifiquen cuando ocurra un error 500 o 404. Así podrás actuar rápido.

Recuerda que tanto el error 500 como el error 404 son problemas comunes y, con esta guía, tienes todas las herramientas para solucionarlos por ti mismo. Si te encuentras atascado, no dudes en buscar ayuda en foros especializados o contactar con el soporte técnico de tu hosting. ¡Tu tienda PrestaShop volverá a funcionar en poco tiempo!