Errores frecuentes de PrestaShop y soluciones en DirectAdmin

¿Por qué PrestaShop da errores y qué tiene que ver DirectAdmin?

Si estás leyendo esto, probablemente te has encontrado con algún mensaje de error en tu tienda PrestaShop y no sabes por dónde empezar. Tranquilo, es mucho más común de lo que parece y, en la mayoría de los casos, tiene una solución clara y sencilla.

Cuando hablamos de errores prestashop, no siempre significa que la tienda esté rota o que hayas perdido datos. Muchas veces, el problema viene de la configuración del servidor donde está alojada tu web, y aquí es donde entra en juego el panel de control DirectAdmin. Este panel es el "cuadro de mandos" de tu servidor, desde donde gestionas bases de datos, dominios, archivos y versiones de PHP.

El objetivo de este artículo es que aprendas a identificar los problemas prestashop más habituales cuando usas DirectAdmin y, sobre todo, que sepas solucionar errores prestashop paso a paso, sin necesidad de ser un experto en programación. Vamos a ello.

Error 500: el clásico que asusta a todos

El temido Error 500 (Internal Server Error) es, probablemente, el más frecuente en prestashop directadmin. Aparece de repente, sin avisar, y puede deberse a varias causas. La buena noticia es que casi siempre tiene solución.

¿Qué lo causa?

Las causas más comunes son:

Un archivo .htaccess corrupto o con directivas incompatibles.
Permisos de archivos o carpetas incorrectos.
Un módulo recién instalado que genera un conflicto.
Límites de memoria PHP agotados.

Cómo solucionarlo paso a paso

Accede a tu panel DirectAdmin con tus credenciales.
Ve a Gestor de archivos (File Manager) y busca la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta).
Localiza el archivo .htaccess. Si no lo ves, activa la opción de "mostrar archivos ocultos".
Renombra el archivo a algo como .htaccess.bak para desactivarlo temporalmente.
Recarga tu tienda. Si el error desaparece, el problema era el .htaccess. Puedes regenerarlo desde el panel de administración de PrestaShop en Parámetros avanzados > Rendimiento (pulsando el botón de regenerar).
Si el error persiste, revisa los permisos de archivos y carpetas. Las carpetas deben estar en 755 y los archivos en 644. Puedes seleccionar todo y cambiarlo desde el propio gestor de archivos de DirectAdmin.

[WARNING] No cambies los permisos de la carpeta var/cache a 777 de forma permanente. Es una solución temporal y un riesgo de seguridad grave. Úsalo solo para pruebas y vuelve a dejarlo en 755.

Error de conexión a la base de datos

Otro de los fallos prestashop más desesperantes es el mensaje de "Error al conectar con la base de datos" o "Cannot connect to DB". Esto suele pasar después de mover la tienda a otro servidor o al cambiar la contraseña de la base de datos.

Pasos para diagnosticar y arreglar

Entra en DirectAdmin y ve a la sección MySQL Management.
Verifica que la base de datos existe y que el usuario asociado tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).
Comprueba que la contraseña no tenga caracteres extraños que puedan estar mal interpretados en el archivo de configuración.
Abre el archivo config/settings.inc.php en la raíz de tu PrestaShop (en versiones antiguas) o app/config/parameters.php (en versiones modernas). Revisa que el nombre de la base de datos, el usuario y la contraseña coinciden exactamente con lo que ves en DirectAdmin.
También asegúrate de que el servidor de base de datos sea localhost o 127.0.0.1, que es lo habitual en estos entornos.

[TIP] Si acabas de cambiar la contraseña de la base de datos desde DirectAdmin, recuerda actualizarla también en el archivo de configuración de PrestaShop. Es un detalle que se olvida mucho.

La tienda va lenta: cuellos de botella y caché

Una tienda lenta no es un error como tal, pero es un problema prestashop que afecta directamente a tus ventas y a tu posicionamiento SEO. Si tu tienda tarda en cargar, los usuarios se van y Google te penaliza.

Causas habituales

Caché desactivada o mal configurada en PrestaShop.
Módulos mal optimizados o demasiados módulos activos.
La versión de PHP no es la adecuada.
No tienes activada la compresión o el caché de servidor.

Solución práctica

En el panel de administración de PrestaShop, ve a Parámetros avanzados > Rendimiento.
Activa la caché de combinación de archivos CSS y JavaScript.
Activa el caché de servidor (si tu hosting lo permite, mejor usa Redis o Memcached desde DirectAdmin).
En DirectAdmin, ve a PHP Settings y cambia la versión de PHP a una más reciente (PHP 8.1 o 8.2 suelen dar muy buenos resultados con PrestaShop).
Aumenta el límite de memoria de PHP a al menos 256M. En DirectAdmin puedes hacerlo desde PHP Configuration o editando el archivo php.ini.

[INFO] Si usas Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106. Allí también puedes gestionar la versión de PHP y los límites de memoria de forma visual.

El clásico "Error de escritura" en carpetas de caché

PrestaShop necesita escribir archivos temporales en sus carpetas de caché. Si el servidor no tiene permisos de escritura, verás errores como "Cannot write to cache" o la tienda se queda en blanco.

Cómo solucionarlo

Accede al Gestor de archivos de DirectAdmin.
Navega a la carpeta var/cache (en PrestaShop 1.7 y 8) o cache (en PrestaShop 1.6).
Borra el contenido de la carpeta, pero no la carpeta en sí.
Asegúrate de que la carpeta tenga permisos 755 y sea propiedad del usuario correcto (el mismo que ejecuta PHP). En DirectAdmin, esto suele estar bien por defecto.
Vuelve a cargar la tienda. Si el problema persiste, desactiva la caché desde el panel de administración y vuelve a activarla.

[WARNING] Nunca borres la carpeta var/cache entera, solo su contenido. Si la eliminas por completo, PrestaShop la recreará al recargar, pero es más seguro no arriesgarse.

Problemas con la URL amigable (mod_rewrite)

Si tus URLs de producto dan error 404 o te llevan a la página de inicio, el problema suele estar en el mod_rewrite de Apache o en el archivo .htaccess de nuevo.

Solución en DirectAdmin

Ve a DirectAdmin > Domain Setup y asegúrate de que tu dominio está correctamente configurado.
Comprueba que Apache tiene el módulo mod_rewrite habilitado. En DirectAdmin, normalmente está activado por defecto, pero si tienes dudas, contacta con tu proveedor.
Regenera el .htaccess desde el panel de PrestaShop: Parámetros avanzados > URL y activa la opción de "URLs amigables".
Si no puedes acceder al panel, edita manualmente el .htaccess y asegúrate de que contiene las reglas de rewrite de PrestaShop. Puedes generar un archivo básico desde la documentación oficial.

[TIP] Después de regenerar el .htaccess, ve a Parámetros avanzados > Rendimiento y limpia la caché. A veces el navegador guarda la versión antigua y parece que no ha cambiado nada.

Error al subir imágenes o productos

¿Te aparece un error al subir una imagen de producto? ¿O el producto se guarda pero la imagen no aparece? Esto suele estar relacionado con los límites de subida de archivos en el servidor.

Ajusta los límites en DirectAdmin

Ve a PHP Settings en DirectAdmin.
Busca las directivas upload_max_filesize y post_max_size.
Cámbialas a valores como 64M o 128M para dar margen.
Guarda los cambios y reinicia PHP si es necesario (en DirectAdmin suele aplicarse al momento).

También revisa que la carpeta img o img/p tenga permisos 755. Si usas una tienda con muchos productos, este paso es fundamental.

Errores de actualización de PrestaShop

Actualizar PrestaShop es una tarea delicada. Es muy común que después de una actualización aparezcan fallos prestashop como páginas en blanco, errores de módulos incompatibles o problemas con la base de datos.

Qué hacer si la actualización falla

Haz una copia de seguridad completa (archivos y base de datos) antes de cualquier actualización. En DirectAdmin, puedes usar la herramienta de backup integrada.
Si ya has actualizado y algo falla, revisa el registro de errores en var/logs (en versiones modernas) o log/ (en versiones antiguas).
Desactiva todos los módulos no oficiales y vuelve a probar.
Si la página está en blanco, activa el modo depuración de PrestaShop editando el archivo config/defines.inc.php y cambiando _PS_MODE_DEV_ a true. Así verás el error exacto en pantalla.

[WARNING] No dejes el modo depuración activado en producción. Desactívalo en cuanto termines de diagnosticar, ya que muestra información sensible.

Preguntas frecuentes (FAQ) sobre errores en PrestaShop

¿Por qué mi tienda PrestaShop se cae sola y aparece un error 500?

Suele ser por un problema de memoria o un conflicto de módulos. Revisa el límite de memoria PHP en DirectAdmin y desactiva módulos recientes para probar.

¿Cómo sé si el problema es de mi hosting o de PrestaShop?

Si puedes acceder a DirectAdmin y ver los archivos, el servidor está activo. Prueba a crear un archivo info.php con el contenido <?php phpinfo(); ?> en la raíz. Si se ve la información de PHP, el servidor funciona y el problema es de configuración de PrestaShop.

¿Es normal que PrestaShop vaya lento en un hosting compartido?

Es posible, pero no debería ser la norma. Activa la caché, usa una versión de PHP moderna y elimina módulos innecesarios. Si sigue lento, considera cambiar a un plan con más recursos.

¿Qué hago si no puedo entrar al panel de administración de PrestaShop?

Puedes intentar acceder por FTP o por el Gestor de archivos de DirectAdmin y desactivar módulos renombrando la carpeta modules a modules_backup. Luego crea una carpeta modules vacía y prueba a entrar. Así identificarás si un módulo está bloqueando el acceso.

¿Cómo restauro mi tienda desde una copia de seguridad en DirectAdmin?

DirectAdmin tiene una sección de Backup/Restore donde puedes subir o restaurar copias completas. Asegúrate de restaurar tanto los archivos como la base de datos.

Consejos finales para evitar problemas prestashop

La prevención es la mejor herramienta. Sigue estas buenas prácticas y reducirás drásticamente los fallos prestashop:

Mantén PrestaShop actualizado a la última versión estable.
Haz copias de seguridad semanales de archivos y base de datos.
No instales módulos piratas o de fuentes desconocidas.
Revisa los logs de DirectAdmin y de PrestaShop periódicamente.
Usa una contraseña segura para la base de datos y el panel de administración.
No dejes archivos de instalación (carpeta install) en el servidor.

[INFO] Recuerda que si tu hosting usa Syspanel (HestiaCP), el acceso al panel se realiza por el puerto 2106. La gestión de archivos y bases de datos es similar a DirectAdmin, pero con una interfaz diferente. Los principios que hemos visto aquí aplican igualmente.

Conclusión

Los errores prestashop son parte del día a día de cualquier tienda online, pero no tienen por qué ser un dolor de cabeza. Con DirectAdmin tienes las herramientas necesarias para diagnosticar y solucionar errores prestashop de forma autónoma, sin depender de un técnico para cada pequeño contratiempo.

Recuerda siempre empezar por lo más simple: permisos, caché y versión de PHP. La mayoría de los problemas se resuelven ahí. Si el error persiste, revisa los logs y busca ayuda en la comunidad o en tu proveedor de hosting, pero ya con un diagnóstico más claro.

Espero que esta guía te haya sido útil y que la próxima vez que veas un error en tu tienda, sepas exactamente por dónde empezar. ¡Mucha suerte con tu negocio online!