🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Errores comunes de PrestaShop en DirectAdmin y cómo solucionarlos

Actualizado el 15 de mayo de 2026

¿Tu tienda PrestaShop se ha vuelto lenta, da errores al instalar módulos, o ves pantallas en blanco después de un cambio? Si tu tienda está alojada en un servidor con DirectAdmin, es muy probable que algunos de estos problemas sean más comunes de lo que crees.

En este artículo, vamos a recorrer los errores PrestaShop DirectAdmin más típicos, desde problemas de permisos hasta conflictos con PHP, y te daremos soluciones paso a paso para que puedas solucionar PrestaShop DirectAdmin sin necesidad de ser un experto en sistemas.

Vamos a desglosar cada fallo, su causa y cómo resolverlo, manteniendo un tono claro y práctico. Así, si ves algún PrestaShop fallos DirectAdmin, podrás identificarlo y arreglarlo rápidamente.

1. Permisos de archivos incorrectos (el error más común)

Uno de los errores PrestaShop DirectAdmin más frecuentes ocurre después de migrar, instalar o actualizar la tienda. De repente, no puedes subir imágenes, los módulos fallan o ves un mensaje como "No se puede escribir en la carpeta /cache".

¿Por qué ocurre?

PrestaShop necesita ciertos permisos para leer y escribir archivos en el servidor. DirectAdmin, por defecto, asigna permisos 755 para carpetas y 644 para archivos. Sin embargo, a veces al subir archivos por FTP o al restaurar una copia de seguridad, los permisos se desconfiguran.

Solución paso a paso:

  1. Accede a tu panel de DirectAdmin.
  2. Ve a Gestor de Archivos (File Manager) y navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o domains/tudominio.com/public_html).
  3. Selecciona todos los archivos y carpetas (Ctrl+A).
  4. Haz clic en Cambiar permisos (o Change Permissions).
  5. Marca las siguientes opciones:
    • Carpetas: 755 (rwxr-xr-x)
    • Archivos: 644 (rw-r--r--)
  6. Aplica los cambios.

[TIP] Si tienes acceso a SSH, puedes hacerlo más rápido con estos comandos:
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;

  1. No olvides las carpetas especiales: PrestaShop necesita permisos 777 temporalmente en:

    • /cache
    • /log
    • /img
    • /modules
    • /themes/tu-tema/cache
    • /download
    • /upload
    • /translations

    Cambia estas carpetas a 777 solo durante la resolución del error. Luego, vuelve a 755 por seguridad.

2. Error de conexión a la base de datos (Database connection failed)

Este es otro clásico. De repente, tu tienda muestra un mensaje como "No se puede conectar con la base de datos" o "Error de conexión a la base de datos". Esto puede ocurrir por cambios en la contraseña, migraciones o simplemente porque el servidor se quedó sin recursos.

Solución:

  1. Revisa el archivo de configuración: Conéctate por FTP o File Manager y abre /config/settings.inc.php (en PrestaShop 1.6) o /app/config/parameters.php (en PrestaShop 1.7+).
  2. Verifica estos valores:
    • _DB_SERVER_: suele ser localhost o la IP del servidor.
    • _DB_NAME_: el nombre de tu base de datos.
    • _DB_USER_: el usuario de la base de datos.
    • _DB_PASSWD_: la contraseña.
  3. Prueba la conexión desde DirectAdmin:
    • Ve a MySQL Management > phpMyAdmin.
    • Intenta iniciar sesión con los mismos datos. Si no funciona, la contraseña o el usuario están mal.
  4. Restablece la contraseña:
    • En DirectAdmin, ve a MySQL Management.
    • Selecciona tu base de datos y usuario, y cambia la contraseña.
    • Actualiza el archivo de configuración de PrestaShop con la nueva contraseña.

[WARNING] Si usas un hosting compartido, a veces el servidor cambia la IP del host de la base de datos. En lugar de localhost, puede que necesites poner 127.0.0.1 o la IP real del servidor.

3. Error 500 o pantalla en blanco (White Screen of Death)

La temida pantalla en blanco (WSoD) es uno de los PrestaShop fallos DirectAdmin más frustrantes. No ves ningún mensaje de error, solo una página vacía.

Causas comunes:

  • Límite de memoria PHP excedido.
  • Módulo incompatible.
  • Error en el archivo .htaccess.
  • Permisos incorrectos (ya vimos cómo solucionarlo).

Solución:

  1. Habilita la visualización de errores:

    • Edita el archivo /config/defines.inc.php.
    • Busca la línea: define('_PS_MODE_DEV_', false);
    • Cámbiala a: define('_PS_MODE_DEV_', true);
    • Guarda y recarga la página. Ahora verás el error específico.

  2. Aumenta el límite de memoria PHP:

    • En DirectAdmin, ve a PHP Settings o Custom PHP Configuration.
    • Busca memory_limit y cámbialo a 256M o 512M.
    • También ajusta max_execution_time a 300.

  3. Desactiva módulos problemáticos:

    • Si el error ocurrió después de instalar un módulo, renombra la carpeta del módulo en /modules/ (por ejemplo, moduloproblema_old).
    • Luego, limpia la caché de PrestaShop desde el panel de administración (si puedes acceder) o manualmente borrando /cache/smarty/cache/ y /cache/smarty/compile/.

  4. Regenera el .htaccess:

    • Ve a tu panel de administración de PrestaShop > Parámetros de la tienda > Tráfico y SEO.
    • Haz clic en Guardar sin cambiar nada. Esto regenera el archivo.

[INFO] Si no puedes acceder al panel, crea un archivo .htaccess vacío en la raíz y luego vuelve a generarlo desde el panel.

4. Problemas con la versión de PHP

PrestaShop es muy sensible a la versión de PHP. Si usas una versión muy antigua (PHP 5.6) o muy moderna (PHP 8.2+ sin compatibilidad), tu tienda puede dar errores de compatibilidad, funciones obsoletas o simplemente no cargar.

¿Cómo verificarlo y solucionarlo?

  1. Revisa la versión actual:

    • En DirectAdmin, ve a PHP Version Selector o PHP Settings.
    • Verás la versión activa.

  2. Versiones recomendadas por PrestaShop:

    • PrestaShop 1.6: PHP 5.6 a 7.1.
    • PrestaShop 1.7: PHP 7.1 a 8.0 (mejor 7.4).
    • PrestaShop 8.x: PHP 7.4 a 8.1.

  3. Cambia la versión:

    • En DirectAdmin, selecciona la versión de PHP adecuada.
    • Si tu hosting lo permite, puedes hacerlo por dominio en PHP Selector.
    • Guarda los cambios y espera unos minutos.

  4. Prueba la tienda:

    • Si el error era por funciones obsoletas, debería resolverse.

[WARNING] Si cambias de PHP 5.6 a 8.0 de golpe, muchos módulos antiguos dejarán de funcionar. Hazlo gradualmente: primero a 7.1, luego a 7.4, y finalmente a 8.0.

5. Caché de Smarty corrupta o llena

La caché de Smarty es la que guarda las plantillas compiladas de PrestaShop. Si se corrompe, verás errores de diseño, productos que no se muestran o páginas que no cargan.

Solución:

  1. Borra la caché manualmente:

    • Conéctate por FTP o File Manager.
    • Elimina TODO el contenido de las carpetas:
      • /cache/smarty/cache/
      • /cache/smarty/compile/
    • No borres las carpetas en sí, solo su contenido.

  2. Limpia la caché desde el panel:

    • Ve a Parámetros avanzados > Rendimiento.
    • Haz clic en Limpiar la caché (tanto de Smarty como de compilación).

  3. Desactiva la caché temporalmente:

    • En la misma sección, cambia Caché a No y Forzar compilación a Sí.
    • Guarda y recarga la tienda. Luego, vuelve a activar la caché.

[TIP] Si tienes muchos productos, programa la limpieza de caché cada cierto tiempo o usa un módulo de optimización.

6. Error de subida de imágenes (límite de tamaño)

Al intentar subir imágenes de productos, te aparece un error como "El archivo es demasiado grande" o "No se puede subir la imagen".

Causa:

El límite de subida de PHP está configurado bajo en DirectAdmin.

Solución:

  1. Aumenta los límites en PHP:

    • En DirectAdmin, ve a PHP Settings.
    • Aumenta estos valores:
      • upload_max_filesize = 32M o 64M
      • post_max_size = 64M o 128M
      • max_execution_time = 300

  2. Si usas un servidor con Syspanel (HestiaCP):

    • Accede a través del puerto 2106.
    • Ve a Advanced Options > PHP Configuration.
    • Ajusta los mismos parámetros.

  3. Verifica el límite en PrestaShop:

    • En el panel de administración, ve a Parámetros de la tienda > Imágenes.
    • Asegúrate de que el tamaño máximo permitido no sea menor al de PHP.

[INFO] Si el error persiste, revisa el archivo .htaccess o php.ini local. A veces el hosting tiene un límite global que no puedes superar.

7. Módulos que no se instalan o actualizan

Otro de los errores PrestaShop DirectAdmin frecuentes son los módulos que fallan al instalar o actualizar, mostrando mensajes como "No se puede conectar con el servidor de módulos" o "Error de permisos".

Solución:

  1. Verifica los permisos de la carpeta /modules:

    • Debe tener permisos 755 (o 777 temporalmente).
    • También revisa /cache y /config.

  2. Comprueba la conexión a Internet del servidor:

    • A veces el servidor no tiene acceso a Internet para descargar módulos.
    • Puedes descargar el módulo manualmente desde el sitio web del desarrollador y subirlo por FTP a /modules/.

  3. Desactiva el modo de seguridad:

    • En PrestaShop 1.7+, ve a Parámetros avanzados > Seguridad.
    • Desmarca Permitir la instalación de módulos desde URL externa si está activo.

  4. Actualiza manualmente:

    • Si el módulo ya está instalado, desinstálalo, borra la carpeta, sube la nueva versión y vuelve a instalarlo.

[TIP] Si usas módulos de pago, asegúrate de que la versión de PrestaShop sea compatible.

8. Error de SEO: URLs amigables no funcionan

Después de activar las URLs amigables, las páginas dan error 404 o redirigen mal.

Solución:

  1. Regenera el archivo .htaccess:

    • Ve a Parámetros de la tienda > Tráfico y SEO.
    • Haz clic en Guardar sin cambios.

  2. Verifica que el módulo mod_rewrite esté activo en Apache:

    • En DirectAdmin, ve a Custom HTTPD Configuration o Apache Configuration.
    • Asegúrate de que mod_rewrite esté habilitado.

  3. Comprueba la configuración de la tienda:

    • En Parámetros de la tienda > Tráfico y SEO, marca URLs amigables como Sí.
    • Guarda y prueba.

  4. Si usas Syspanel (HestiaCP):

    • Accede por el puerto 2106.
    • Ve a Web Domain > Advanced Options.
    • Activa Rewrite Rules y guarda.

[WARNING] Si tienes un plugin de caché, limpia la caché después de regenerar el .htaccess.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop se vuelve lento en DirectAdmin?

Puede deberse a:

  • Caché llena o corrupta.
  • Módulos pesados o mal optimizados.
  • Límite de memoria PHP bajo.
  • Base de datos sin optimizar (índices, tablas rotas).

¿Cómo puedo saber si tengo un error de PHP?

Habilita el modo desarrollo en /config/defines.inc.php cambiando _PS_MODE_DEV_ a true. Verás los errores directamente en pantalla.

¿Es seguro dejar permisos 777 en las carpetas?

No. Solo para solucionar errores temporalmente. Después de la resolución, vuelve a 755 para evitar vulnerabilidades.

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

Puedes:

  • Desactivar módulos renombrando carpetas en /modules/.
  • Regenerar el .htaccess manualmente.
  • Restaurar una copia de seguridad de los archivos.

¿DirectAdmin tiene algún límite de recursos que afecte a PrestaShop?

Sí, especialmente en planes compartidos. Revisa los límites de memoria, CPU y conexiones a la base de datos. Si tu tienda crece, considera un VPS o servidor dedicado.

Resumen final

Los errores PrestaShop DirectAdmin son comunes, pero en su mayoría tienen soluciones sencillas. Recuerda:

  • Permisos: 755 en carpetas, 644 en archivos, 777 solo temporal.
  • PHP: Usa la versión compatible con tu PrestaShop.
  • Caché: Límpiala regularmente.
  • Base de datos: Verifica credenciales y optimiza tablas.
  • Módulos: Actualiza solo los compatibles.

Si sigues estos pasos, podrás solucionar PrestaShop DirectAdmin sin complicaciones. Y si el problema persiste, no dudes en contactar a tu proveedor de hosting, ya que a veces el error está en la configuración del servidor.

[TIP FINAL] Haz siempre copias de seguridad antes de hacer cambios grandes. ¡Tu tienda te lo agradecerá!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel