Solucionar errores de PrestaShop en DirectAdmin | FAQ y guía

Si tienes una tienda online con PrestaShop, es probable que en algún momento te encuentres con algún error. No te preocupes, es más común de lo que piensas. La mayoría de estos problemas tienen solución y, lo mejor de todo, puedes resolverlos tú mismo desde el panel de control de tu hosting, en este caso DirectAdmin.

En esta guía vamos a repasar los errores PrestaShop DirectAdmin más frecuentes, entender por qué ocurren y, lo más importante, cómo arreglarlos paso a paso. Mi objetivo es que, aunque no seas un experto en tecnología, puedas mantener tu tienda funcionando sin sobresaltos.

1. El temido "Error 500 – Internal Server Error"

Este es, sin duda, uno de los errores PrestaShop comunes más frustrantes. La pantalla se queda en blanco o muestra un mensaje genérico. No te asustes: casi siempre es culpa de un archivo de configuración o de los permisos de los archivos.

¿Por qué ocurre?

Un plugin o módulo recién instalado está causando un conflicto.
El archivo .htaccess está dañado o tiene reglas incorrectas.
Los permisos de las carpetas o archivos no son los adecuados.
El límite de memoria de PHP se ha excedido.

Cómo solucionarlo desde DirectAdmin

Accede a DirectAdmin: Abre tu navegador y ve a tudominio.com:2222. Introduce tu usuario y contraseña.
Ve al Administrador de Archivos: Busca el icono que dice "Administrador de Archivos" o "File Manager". Dentro, navega hasta la carpeta donde está instalado tu PrestaShop (normalmente public_html o una subcarpeta).
Renombra el archivo .htaccess: Localiza el archivo llamado .htaccess (puede estar oculto, activa la opción "Mostrar archivos ocultos"). Cámbiale el nombre a algo como .htaccess_old. Esto desactivará las reglas de reescritura de URL.
Prueba tu tienda: Vuelve a cargar tu web. Si funciona, el problema estaba en el .htaccess. Puedes regenerarlo desde el panel de administración de PrestaShop: ve a Configuración de la tienda > Tráfico y SEO > URL amigables y guarda la configuración sin cambiar nada.
Revisa los permisos: Si el error persiste, vuelve al Administrador de Archivos. Selecciona todas las carpetas (una por una o todas juntas) y haz clic en "Cambiar permisos". Las carpetas deben tener permisos 755 y los archivos 644. No uses 777 por seguridad.
Aumenta la memoria PHP: Vuelve a la pantalla principal de DirectAdmin. Busca la opción "Selector de PHP" o "PHP Settings". Busca la configuración de memory_limit y cámbiala a 256M o 512M. Guarda los cambios.

[TIP] Si después de esto el error sigue, revisa el log de errores. En DirectAdmin, busca la opción "Registros de errores" o "Error Log". Allí verás la línea exacta que causa el problema, lo que te dará una pista muy clara.

2. El molesto "Error de conexión a la base de datos"

Cuando ves "¡No se puede conectar a la base de datos!", el pánico puede invadirte. Pero es un problema muy común y con solución rápida.

¿Por qué ocurre?

Los datos de acceso a la base de datos (usuario, contraseña, nombre) han cambiado.
El servidor de base de datos está caído o sobrecargado.
El archivo de configuración settings.inc.php está corrupto o tiene datos incorrectos.

Cómo solucionarlo desde DirectAdmin

Verifica el estado del servidor MySQL: En DirectAdmin, busca la sección "Servicios" o "Service Monitor". Asegúrate de que "MySQL" o "MariaDB" esté marcado en verde (activo). Si está en rojo, puedes intentar reiniciarlo desde el mismo panel.
Localiza el archivo de configuración: Ve al Administrador de Archivos y navega hasta la carpeta app/config/ dentro de tu instalación de PrestaShop.
Edita parameters.php: Busca el archivo parameters.php. Ábrelo con el editor de texto de DirectAdmin (clic derecho > Editar).
Revisa las credenciales: Busca las líneas que contienen 'database_host', 'database_name', 'database_user' y 'database_password'. Asegúrate de que coincidan exactamente con los datos que te proporcionó tu hosting. Si no los recuerdas, puedes crearlos de nuevo:
- Ve a la sección "MySQL Management" en DirectAdmin.
- Crea una nueva base de datos y un nuevo usuario (o usa uno existente).
- Asigna todos los privilegios al usuario sobre la base de datos.
- Copia esos datos exactos en el archivo parameters.php.
Guarda y prueba: Guarda los cambios y recarga tu tienda.

[WARNING] Ten mucho cuidado al editar parameters.php. Un solo carácter mal escrito (una coma, una comilla) puede romper toda la tienda. Si no estás seguro, haz una copia de seguridad del archivo original antes de modificarlo.

3. La pantalla blanca de la muerte (White Screen of Death)

Este error es similar al 500, pero no muestra ningún mensaje. La página se queda completamente en blanco.

¿Por qué ocurre?

Un módulo defectuoso está generando un error fatal de PHP.
El límite de memoria de PHP es demasiado bajo.
Hay un conflicto con la versión de PHP instalada.

Cómo solucionarlo desde DirectAdmin

Activa el modo de depuración de PrestaShop: Esto te mostrará el error real en la pantalla.
- Ve al Administrador de Archivos y abre el archivo /config/defines.inc.php.
- Busca la línea: define('_PS_MODE_DEV_', false);
- Cámbiala a: define('_PS_MODE_DEV_', true);
- Guarda el archivo. Ahora, al recargar la tienda, verás un mensaje de error detallado.
Desactiva módulos desde la base de datos: Si el error te impide entrar al panel de administración, puedes desactivar módulos manualmente.
- Ve a "phpMyAdmin" desde DirectAdmin (suele estar en la sección "Características extra" o "Base de datos").
- Selecciona tu base de datos de PrestaShop.
- Busca la tabla ps_module (el prefijo puede variar, por ejemplo catalogo_module).
- Haz clic en "Examinar" o "Browse". Verás una lista de todos los módulos.
- Para desactivar un módulo sospechoso, edita su fila y cambia el valor de la columna active de 1 a 0.
Cambia la versión de PHP: En DirectAdmin, busca "Selector de PHP" y prueba con una versión más reciente (por ejemplo, de PHP 7.4 a PHP 8.0 o 8.1). PrestaShop 1.7 y 8.x funcionan mejor con PHP 7.4 o superior.

[INFO] Una vez solucionado el problema, no olvides volver a poner define('_PS_MODE_DEV_', false); en el archivo defines.inc.php. Dejar el modo depuración activo en producción es un riesgo de seguridad.

4. Problemas con las URL amigables (404 o redirecciones incorrectas)

Si tus productos o categorías dan error 404, o las URLs no se ven bien (ej: tutienda.com/index.php?id_product=5), el problema está en la configuración de las URL amigables.

¿Por qué ocurre?

El archivo .htaccess no se ha generado correctamente.
El módulo de reescritura de Apache (mod_rewrite) no está activo.
Has cambiado la URL de la tienda.

Cómo solucionarlo desde DirectAdmin

Regenera el .htaccess: Desde el panel de administración de PrestaShop (si puedes acceder), ve a Configuración de la tienda > Tráfico y SEO > URL amigables. Simplemente haz clic en "Guardar" sin cambiar nada. Esto regenera el archivo.
Si no puedes acceder al panel: Vuelve a hacer lo que hicimos en el error 500: renombra el .htaccess actual y luego entra a tu tienda. PrestaShop lo regenerará automáticamente (a veces necesitas recargar la página de administración).
Activa mod_rewrite en DirectAdmin: No siempre es posible desde el panel de usuario, pero puedes pedirle a tu proveedor de hosting que lo active. Si tienes acceso a "Configuración de Apache" o "Custom HTTPD Config", busca la opción "AllowOverride All" y asegúrate de que esté marcada.

[TIP] Si tu tienda está en una subcarpeta (ej: tudominio.com/tienda), asegúrate de que la configuración de "URL de la tienda" en PrestaShop apunte a esa ruta exacta.

5. Errores al subir imágenes o productos

A veces, al intentar subir una imagen de producto o modificar un artículo, recibes un error o la imagen no se guarda.

¿Por qué ocurre?

Los permisos de la carpeta img o upload son incorrectos.
El límite de subida de archivos en PHP es demasiado bajo.
La imagen pesa demasiado o tiene un formato no soportado.

Cómo solucionarlo desde DirectAdmin

Corrige los permisos de las carpetas: En el Administrador de Archivos, navega a las carpetas img y upload. Ambas deben tener permisos 755 o 777 (aunque 777 no es recomendable por seguridad, a veces es necesario temporalmente). Después de subir los archivos, vuelve a poner 755.
Aumenta los límites de subida: Ve al "Selector de PHP" en DirectAdmin. Busca y aumenta estos valores:
- upload_max_filesize (ej: a 64M)
- post_max_size (ej: a 64M)
- max_execution_time (ej: a 300)
Comprueba el tamaño y formato: Las imágenes de productos no deben superar los 2-3 MB. Usa formatos JPEG o PNG. Si usas WebP, asegúrate de que tu versión de PHP lo soporte.

Preguntas Frecuentes (FAQ) sobre errores PrestaShop DirectAdmin

P: ¿Por qué mi tienda se vuelve muy lenta después de instalar un módulo?
R: Es probable que el módulo consuma muchos recursos. Desde DirectAdmin, puedes desactivarlo temporalmente desde phpMyAdmin (como vimos en el punto 3) o desde el panel de administración. También revisa si hay actualizaciones del módulo.

P: ¿Cómo hago una copia de seguridad de mi tienda desde DirectAdmin?
R: DirectAdmin tiene una herramienta llamada "Backup" o "Copia de seguridad". Selecciona la opción "Crear respaldo" y elige "Base de datos" y "Archivos de dominio". Descarga el archivo generado a tu ordenador. Es tu seguro de vida.

P: Veo un error que dice "Class not found" o "Fatal error: Class...". ¿Qué hago?
R: Esto suele pasar por una actualización incompleta o un módulo mal instalado. La solución más rápida es restaurar una copia de seguridad reciente. Si no tienes, desde DirectAdmin puedes sobrescribir los archivos de PrestaShop con una copia limpia (cuidado con no borrar la carpeta img ni la base de datos).

P: ¿Puedo usar Syspanel en lugar de DirectAdmin?
R: Si tu hosting usa Syspanel (HestiaCP), el proceso es similar. Accede a través del puerto 2106 (tudominio.com:2106). Las herramientas se llaman diferente (por ejemplo, "Administrador de archivos" es "File Manager"), pero los pasos para solucionar errores PrestaShop son los mismos: revisar permisos, editar archivos de configuración y gestionar la base de datos.

P: ¿Qué hago si no puedo acceder ni a DirectAdmin?
R: Contacta con el soporte técnico de tu hosting. Ellos tienen acceso de administrador al servidor y pueden reiniciar servicios o restaurar accesos. Mientras tanto, revisa tu correo electrónico: a veces te envían alertas sobre caídas del servidor.

Conclusión

Los errores PrestaShop DirectAdmin pueden parecer aterradores, pero con un poco de paciencia y siguiendo estos pasos, la mayoría se solucionan en minutos. Recuerda siempre hacer copias de seguridad periódicas y mantener tu PrestaShop y sus módulos actualizados.

Si te has quedado atascado en algún paso, no dudes en buscar ayuda en foros especializados o contactar con tu proveedor de hosting. ¡Tu tienda online puede volver a la vida más rápido de lo que imaginas!