Errores frecuentes de PrestaShop en DirectAdmin y cómo solucionarlos

Primeros pasos: entendiendo qué está pasando con tu PrestaShop

Cuando trabajas con PrestaShop y DirectAdmin, es normal que de vez en cuando aparezcan errores. No estás solo: los problemas prestashop más habituales suelen tener soluciones sencillas que puedes aplicar tú mismo sin necesidad de ser un experto en programación. En esta guía vamos a recorrer los fallos más comunes y, lo más importante, cómo solucionar errores prestashop paso a paso.

Antes de empezar, ten en cuenta que DirectAdmin es el panel de control de tu servidor. Desde ahí gestionas archivos, bases de datos y dominios. Si aún no sabes cómo acceder, búscalo en el correo de bienvenida de tu hosting. Normalmente la URL es algo como https://tudominio.com:2222.

El temido PrestaShop 500 error: causas y soluciones

El prestashop 500 error es, probablemente, el fallo que más sustos da. La pantalla blanca con el texto "Internal Server Error" o simplemente un error 500 puede aparecer por varios motivos. Vamos a ver los más frecuentes y cómo atajarlos.

1. Permisos de archivos incorrectos

PrestaShop necesita permisos específicos en sus carpetas y archivos para funcionar. Si algo se ha cambiado (por ejemplo, al subir archivos por FTP), el sistema se bloquea.

Solución paso a paso:

Entra en DirectAdmin y abre el Administrador de archivos.
Ve a la carpeta donde tienes instalada tu tienda (normalmente public_html o una subcarpeta).
Selecciona todos los archivos y carpetas (Ctrl+A).
Haz clic derecho y elige Cambiar permisos.
Marca 755 para carpetas y 644 para archivos. Si no sabes distinguirlos, aplica 755 a todo primero y prueba. Si sigue fallando, cambia solo los archivos a 644.

[TIP] Si no ves la opción de permisos, activa la casilla "Mostrar archivos ocultos" en el Administrador de archivos. A veces el problema está en el archivo .htaccess que no se ve a simple vista.

2. El archivo .htaccess está dañado

Este archivo controla las redirecciones y el funcionamiento de las URLs amigables. Si se corrompe, el error 500 es casi inmediato.

Cómo regenerarlo:

Ve a tu panel de administración de PrestaShop (si puedes acceder). Si no, hazlo por FTP o por el Administrador de archivos de DirectAdmin.
Renombra el archivo .htaccess a .htaccess.bak.
Entra en el back-office de PrestaShop (si tienes acceso) y ve a Parámetros avanzados > Rendimiento.
Pulsa el botón Regenerar archivo .htaccess.
Si no puedes acceder, crea un archivo vacío llamado .htaccess y luego vuelve a intentar entrar a tu tienda. PrestaShop lo regenerará solo.

[WARNING] No borres el archivo .htaccess sin hacer copia. Si la regeneración falla, podrías quedarte sin URLs amigables y sin acceso a algunas secciones.

3. Memoria PHP insuficiente

PrestaShop es exigente con la memoria. Si tu servidor tiene un límite bajo, verás el error 500 o pantallas en blanco.

Solución en DirectAdmin:

Ve a Configuración de PHP dentro de DirectAdmin (suele estar en la sección "Características extra" o "Configuración de dominio").
Busca la opción memory_limit y súbela a al menos 256M.
Guarda los cambios y reinicia PHP si te lo pide.

Si no encuentras esa opción, prueba a crear un archivo llamado php.ini en la raíz de tu tienda con esta línea:

memory_limit = 256M

Error de conexión a la base de datos en PrestaShop

Otro clásico entre los errores prestashop es el mensaje "Error al conectar con la base de datos". Esto suele pasar después de mover la tienda a otro servidor o al cambiar la contraseña de la base de datos.

Cómo solucionarlo desde DirectAdmin

Abre MySQL Management en DirectAdmin.
Verifica que la base de datos existe y que el usuario tiene todos los privilegios.
Comprueba el archivo config/settings.inc.php en la raíz de tu PrestaShop. Ábrelo con el editor de archivos de DirectAdmin.
Revisa que estos datos coinciden con los de tu base de datos:
- _DB_SERVER_ (normalmente localhost)
- _DB_NAME_
- _DB_USER_
- _DB_PASSWD_

Si has cambiado la contraseña, actualiza el archivo y guarda.

[INFO] A veces el problema no es la contraseña sino el prefijo de las tablas. Si tu base de datos usa ps_, asegúrate de que en el archivo de configuración aparece _DB_PREFIX_ con ese valor.

Base de datos corrupta o con tablas rotas

Si todo parece correcto pero sigue fallando, puede que alguna tabla esté dañada.

Reparación rápida:

Entra en phpMyAdmin desde DirectAdmin.
Selecciona tu base de datos.
Marca todas las tablas con la casilla superior.
En el desplegable de "Con seleccionados", elige Reparar tabla.

Esto suele arreglar errores de conexión intermitentes y problemas de lectura/escritura.

Pantalla blanca en PrestaShop: qué hacer

La temida "pantalla blanca" (o White Screen of Death) es otro de los problemas prestashop más buscados. No muestra ningún mensaje, solo una página en blanco.

Activar el modo depuración

Para saber qué está fallando, necesitas ver el error real.

Pasos:

Abre el archivo config/defines.inc.php en la raíz de tu tienda.
Busca la línea que dice define('_PS_MODE_DEV_', false);
Cámbiala por define('_PS_MODE_DEV_', true);
Guarda y recarga tu tienda. Ahora verás el error específico en lugar de la pantalla blanca.

[WARNING] No olvides volver a poner false cuando termines de arreglarlo. Dejarlo en modo desarrollo en producción es un riesgo de seguridad.

Causas típicas de la pantalla blanca

Un módulo incompatible o mal configurado.
Un override (sobrescritura) de una clase que da error.
Falta de memoria PHP (ya lo vimos antes).
Archivos de caché corruptos.

Solución rápida: borra la carpeta var/cache (en PrestaShop 1.7+ o cache en versiones antiguas) pero no borres el archivo .htaccess que haya dentro. Simplemente elimina el contenido de la carpeta y prueba de nuevo.

Errores de carga lenta o timeout en PrestaShop

A veces no es un error como tal, sino que la tienda tarda muchísimo y acaba dando timeout. Esto pasa mucho en alojamientos compartidos o cuando hay plugins que consumen demasiados recursos.

Optimización básica desde DirectAdmin

Activa la caché de PrestaShop en el back-office: Parámetros avanzados > Rendimiento > Caché.
Activa Combinar archivos CSS y JavaScript en la misma sección.
En DirectAdmin, activa CloudLinux o el acelerador PHP que tengas disponible (normalmente LiteSpeed o Varnish).

Revisa los logs del servidor

En DirectAdmin tienes la sección Logs de errores. Ahí verás si hay algún script que esté dando problemas. Si no entiendes los logs, copia el error y búscalo en Google: seguro que alguien más lo ha tenido.

El error "403 Forbidden" en PrestaShop

Este error significa que el servidor te está denegando el acceso. Puede ser por permisos, por el archivo .htaccess o por una regla de seguridad.

Solución con DirectAdmin

Comprueba que los permisos de la carpeta public_html son 755 o 750.
Revisa el .htaccess por si hay alguna regla que bloquee tu IP o directorio.
Si usas Cloudflare u otro CDN, desactívalo temporalmente para ver si es eso.

[TIP] Si acabas de instalar PrestaShop y te da 403, es muy probable que falten archivos en la subida. Vuelve a subir todo el contenido desde cero, asegurándote de que no se interrumpa la conexión FTP.

Errores al subir imágenes o al instalar módulos

Esto es más común de lo que parece. Normalmente está relacionado con los permisos de las carpetas img, themes o modules.

Cómo arreglarlo

En el Administrador de archivos de DirectAdmin, ve a la carpeta img.
Cambia los permisos a 755.
Haz lo mismo con themes y modules.
Si el error persiste, sube el límite de memoria PHP a 512M temporalmente.

[INFO] Algunos módulos necesitan escribir en carpetas específicas. Si no tienen permisos de escritura, verás errores extraños o el módulo no se instalará.

Cómo evitar futuros problemas prestashop

La prevención es la mejor estrategia. Con unos pocos hábitos, reducirás muchísimo los sustos.

Mantén todo actualizado

PrestaShop a su última versión estable.
PHP a la versión recomendada (8.0 o 8.1 para las versiones recientes).
Módulos y temas siempre actualizados.

Haz copias de seguridad

En DirectAdmin tienes la herramienta de Backups. Configúrala para que haga copias automáticas semanales de:

La carpeta de tu tienda.
La base de datos.

[WARNING] Una copia sin la base de datos no sirve de nada. Asegúrate de que ambas se incluyen en el backup.

Usa un entorno de pruebas

Si vas a hacer cambios grandes (cambiar de tema, instalar muchos módulos), crea una subcarpeta como pruebas.tudominio.com y replica tu tienda ahí. Así, si algo falla, tu tienda principal sigue funcionando.

Activa los logs de PrestaShop

En el back-office, ve a Parámetros avanzados > Información de rendimiento y activa los logs. Te ayudarán a saber qué está pasando antes de que el error se convierta en algo grave.

Preguntas frecuentes sobre errores PrestaShop y DirectAdmin

¿Qué hago si no puedo acceder al back-office de PrestaShop?

Prueba a entrar por la URL directa: tudominio.com/adminXXXXX (donde XXXXX es el nombre de tu carpeta admin). Si no la recuerdas, búscala en el Administrador de archivos. Si el problema es de permisos, renombra la carpeta admin temporalmente y vuelve a intentarlo.

¿Por qué me sale "Error 504 Gateway Timeout"?

Esto significa que el servidor tardó demasiado en responder. Suele pasar con módulos de pago o de envío que hacen llamadas externas. Sube el tiempo de ejecución en la configuración de PHP de DirectAdmin (opción max_execution_time a 300).

¿Puedo usar Syspanel para gestionar mi PrestaShop?

Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es diferente al de DirectAdmin. En Syspanel, el puerto de acceso es el 2106. La gestión de archivos y bases de datos es similar, pero la interfaz cambia. Para errores de PrestaShop, las soluciones de permisos y caché que hemos visto funcionan igual.

¿Qué significa el error "Class '...' not found"?

Es un error típico cuando hay un override roto o un módulo que referencia una clase que no existe. La solución más rápida es desactivar los overrides desde el back-office (Parámetros avanzados > Rendimiento > Desactivar overrides) o renombrar la carpeta override en tu servidor.

¿Necesito contactar con soporte técnico?

Si después de probar todo esto sigues con problemas, no te frustres. Hay errores que requieren acceso a nivel de servidor y ahí ya necesitas a tu proveedor de hosting. Cuando les escribas, adjunta el error exacto y los pasos que ya has probado. Te lo agradecerán y te ayudarán mucho más rápido.

Recuerda que la mayoría de errores prestashop tienen solución en menos de 15 minutos si sabes dónde mirar. DirectAdmin te da todas las herramientas necesarias: gestor de archivos, permisos, base de datos y logs. Con esta guía, ya tienes el mapa para resolver los problemas más comunes.

Si te ha quedado alguna duda, repasa los pasos con calma y no hagas cambios a lo loco. Ve uno a uno, probando después de cada modificación. Así sabrás exactamente qué ha arreglado el problema. Y si algo falla, siempre puedes volver atrás con tu copia de seguridad.