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

Solución de errores comunes en PrestaShop con DirectAdmin

Actualizado el 28 de octubre de 2025

Introducción: Cuando tu tienda PrestaShop falla en DirectAdmin

Gestionar una tienda online con PrestaShop puede ser una experiencia gratificante, pero también puede presentar desafíos técnicos, especialmente cuando el servidor se administra con un panel como DirectAdmin. Los errores pueden aparecer de repente: una página en blanco, un error 500, problemas con la base de datos o conflictos con módulos. No te preocupes. Este artículo está diseñado para guiarte paso a paso en la solución de errores comunes en PrestaShop con DirectAdmin. Aquí encontrarás respuestas claras y prácticas para que puedas solucionar errores PrestaShop sin necesidad de ser un experto en programación.

[INFO] Este artículo está pensado para usuarios que tienen su tienda alojada en un servidor con DirectAdmin. Si usas otro panel como Syspanel (puerto 2106), los principios son similares, aunque algunos pasos pueden variar ligeramente.

¿Por qué ocurren errores en PrestaShop con DirectAdmin?

Antes de entrar en soluciones concretas, es útil entender las causas más frecuentes de los PrestaShop DirectAdmin problemas. Estos suelen agruparse en:

  • Problemas de permisos de archivos: PrestaShop necesita permisos específicos para leer y escribir archivos en el servidor.
  • Configuración de PHP incorrecta: Versiones de PHP incompatibles, límites de memoria bajos o extensiones faltantes.
  • Conflictos con módulos o temas: Un módulo mal programado o un tema incompatible pueden romper la tienda.
  • Errores de base de datos: Conexiones fallidas, tablas corruptas o versiones de MySQL no soportadas.
  • Problemas de caché: Tanto la caché de PrestaShop como la del servidor pueden mostrar contenido obsoleto o causar errores.

Errores Comunes y Cómo Solucionarlos

A continuación, desglosamos los errores más habituales y te damos pasos concretos para resolverlos.

1. Error 500 - Internal Server Error

Este es uno de los errores más frustrantes porque no da detalles. La causa suele ser un archivo .htaccess corrupto, un módulo conflictivo o un problema de PHP.

Solución paso a paso:

  1. Accede a DirectAdmin: Ingresa a tu panel de control. Normalmente es tudominio.com:2222.
  2. Ve al administrador de archivos: Busca la opción "File Manager" o "Administrador de Archivos".
  3. Localiza el archivo .htaccess: Está en la raíz de tu instalación de PrestaShop (la carpeta public_html o domains/tudominio.com/public_html).
  4. Renombra el archivo: Cámbiale el nombre a algo como .htaccess_backup. Esto desactiva temporalmente las reglas de reescritura.
  5. Prueba tu tienda: Si el error desaparece, el problema está en el .htaccess. Ve a "Parámetros de la tienda > Tráfico y SEO" en el backoffice de PrestaShop y haz clic en "Guardar" para regenerarlo.
  6. Si el error persiste: El problema puede ser un módulo. Ve a la carpeta modules dentro de public_html y renombra temporalmente la carpeta del último módulo que instalaste (por ejemplo, micodigo_modulo a micodigo_modulo_backup). Repite la prueba.

[TIP] Si no puedes acceder al backoffice, usa un cliente FTP (como FileZilla) para realizar estos cambios.

2. Página en Blanco (White Screen of Death)

La famosa "pantalla blanca" suele deberse a un error de PHP que no se muestra por configuración. Para ver el error real, debemos habilitar la visualización de errores.

Solución paso a paso:

  1. Busca el archivo config/defines.inc.php: Está en la raíz de tu PrestaShop.
  2. Edítalo con un editor de texto: Busca la línea que dice:
    define('_PS_MODE_DEV_', false);
    Cámbiala a:
    define('_PS_MODE_DEV_', true);
    y guarda el archivo.
  3. Recarga tu tienda: Ahora deberías ver un mensaje de error específico (por ejemplo, "Fatal error: Allowed memory size exhausted..."). Este mensaje te dará la pista definitiva.
  4. Soluciona según el error:
    • Si es "memory size exhausted": Aumenta el límite de memoria de PHP. Puedes hacerlo desde DirectAdmin en "PHP Settings" o creando un archivo php.ini en la raíz con el contenido: memory_limit = 256M.
    • Si es "Class not found" o "Call to undefined function": El problema es de un módulo o tema. Desactívalo renombrando su carpeta en modules o themes.
  5. Vuelve a desactivar el modo desarrollo: Cambia _PS_MODE_DEV_ de vuelta a false para evitar mostrar información sensible a los visitantes.

3. Error de Conexión a la Base de Datos

Este error suele aparecer como "Cannot connect to database" o "Error establishing a database connection". Las causas típicas son cambios en la contraseña de la base de datos o corrupción de archivos de configuración.

Solución paso a paso:

  1. Localiza el archivo app/config/parameters.php: Es el archivo que guarda los datos de conexión a la base de datos.
  2. Verifica los datos: Abre el archivo y busca las líneas: 
    'database_host' => 'localhost',
'database_name' => 'tu_nombre_db',
'database_user' => 'tu_usuario_db',
'database_password' => 'tu_contraseña',
    Asegúrate de que coinciden con los datos de tu base de datos en DirectAdmin.
  3. Comprueba la base de datos en DirectAdmin:
    • Ve a "MySQL Management" o "Base de Datos MySQL".
    • Verifica que el usuario y la base de datos existen y que el usuario tiene todos los privilegios.
    • Si cambiaste la contraseña recientemente, actualízala en el archivo parameters.php.
  4. Reparar la base de datos: Desde DirectAdmin, puedes usar phpMyAdmin. Selecciona tu base de datos, marca todas las tablas y en el menú desplegable elige "Reparar tabla".

[WARNING] Siempre haz una copia de seguridad de tu base de datos antes de hacer cambios. Puedes hacerlo desde phpMyAdmin o desde DirectAdmin.

4. Error de Permisos de Archivos

PrestShop necesita permisos específicos para funcionar. Si ves errores al subir imágenes, al instalar módulos o al escribir en la caché, es probable que los permisos estén mal.

Solución paso a paso:

  1. Accede al "File Manager" de DirectAdmin.
  2. Selecciona la carpeta raíz de PrestaShop (normalmente public_html).
  3. Cambia los permisos de las siguientes carpetas a 755:
    • /cache
    • /config
    • /img
    • /log
    • /mails
    • /modules
    • /themes
    • /translations
    • /upload
    • /download
  4. Cambia los permisos de los archivos a 644:
    • Puedes hacerlo de forma masiva seleccionando todos los archivos y cambiando los permisos.
  5. Para archivos específicos como config/defines.inc.php o index.php, el permiso 644 es suficiente.
  6. Si usas un tema que requiere permisos especiales, consulta la documentación del mismo.

[TIP] La mayoría de los paneles de control permiten cambiar permisos de forma recursiva. Marca la opción "Recursive" o "Aplicar a subdirectorios" para que los cambios afecten a todas las subcarpetas y archivos.

5. Problemas con la Caché

A veces, una caché desactualizada o corrupta puede causar errores visuales o de funcionalidad.

Solución paso a paso:

  1. Limpia la caché de PrestaShop:
    • Ve al backoffice: "Parámetros de la tienda > Rendimiento".
    • Haz clic en "Limpiar la caché" en la sección "Caché".
    • También puedes limpiar la caché de SMARTY haciendo clic en "Vaciar la caché" en la parte superior.
  2. Limpia la caché del servidor (DirectAdmin):
    • Algunos servidores tienen un plugin de caché (como Varnish o Redis). Puedes limpiarlo desde "PHP Settings" o "Caching".
    • Si no ves la opción, contacta a tu proveedor de hosting.
  3. Desactiva temporalmente la caché:
    • En "Parámetros de la tienda > Rendimiento", cambia "Usar la caché" a "No" y guarda. Luego vuelve a probar.

6. Errores al Instalar Módulos o Temas

Es común que al instalar un módulo aparezcan errores como "No se puede instalar el módulo" o "El archivo no es válido".

Solución paso a paso:

  1. Verifica la compatibilidad: Asegúrate de que el módulo es compatible con tu versión de PrestaShop y con PHP. Puedes ver la versión de PHP en DirectAdmin en "PHP Settings".
  2. Aumenta los límites de PHP: A veces la instalación falla por falta de memoria. En DirectAdmin, ve a "PHP Settings" y aumenta:
    • max_execution_time a 300
    • upload_max_filesize a 64M
    • post_max_size a 64M
    • memory_limit a 256M
  3. Instala manualmente:
    • Descarga el módulo en tu ordenador.
    • Descomprímelo y sube la carpeta a la carpeta modules de tu PrestaShop usando FTP o el File Manager.
    • Ve al backoffice a "Módulos > Gestor de Módulos" y busca el módulo en la lista. Debería aparecer para instalarlo.

FAQ: Preguntas Frecuentes sobre Errores en PrestaShop con DirectAdmin

P: ¿Cómo sé qué versión de PHP usa mi PrestaShop?
R: En DirectAdmin, ve a "PHP Settings". Allí verás la versión actual. PrestaShop 1.6 funciona bien con PHP 5.6 o 7.0, y PrestaShop 1.7 y 8 necesitan PHP 7.1 o superior (idealmente 7.4 u 8.0).

P: Mi tienda se vuelve lenta, ¿qué hago?
R: Primero, limpia la caché. Luego, revisa si hay módulos que consuman muchos recursos. Desde DirectAdmin, puedes ver el uso de recursos en "Process Manager". También considera activar la compresión GZIP y usar una CDN.

P: ¿Cómo hago una copia de seguridad de mi tienda en DirectAdmin?
R: DirectAdmin tiene una herramienta de backup. Ve a "Backup" o "Copias de Seguridad" y selecciona "Crear copia de seguridad". Marca "Base de datos" y "Archivos". Descarga el archivo generado a tu ordenador.

P: No puedo acceder al backoffice, ¿qué hago?
R: Si olvidaste la contraseña, puedes cambiarla desde la base de datos con phpMyAdmin. Busca la tabla ps_employee, localiza tu usuario y genera un hash MD5 de tu nueva contraseña (puedes usar generadores online). Si el problema es técnico, renombra la carpeta modules a modules_backup para desactivar todos los módulos temporalmente.

P: ¿Qué hago si aparece "500 Internal Server Error" después de mover mi tienda?
R: Esto es común. Regenera el archivo .htaccess como se explicó antes. Además, verifica que las rutas en la base de datos estén actualizadas. Puedes usar una consulta SQL en phpMyAdmin: UPDATE ps_shop_url SET domain='tudominio.com', domain_ssl='tudominio.com' WHERE id_shop_url=1;

Conclusión: Mantén tu PrestaShop Saludable en DirectAdmin

Resolver errores PrestaShop DirectAdmin no tiene por qué ser una pesadilla. La clave está en la paciencia y en seguir un método lógico: identifica el error, verifica permisos, revisa la configuración de PHP y la base de datos, y no dudes en desactivar módulos sospechosos. Recuerda que tu panel de control (ya sea DirectAdmin o Syspanel en el puerto 2106) es tu mejor aliado para inspeccionar y corregir problemas.

[INFO] Si después de seguir todos estos pasos el error persiste, contacta a tu proveedor de hosting. Ellos pueden revisar los logs del servidor y darte información más detallada.

Esperamos que esta guía te haya sido de gran ayuda. Ahora ya sabes cómo solucionar errores PrestaShop de manera autónoma y efectiva. ¡Tu tienda online volverá a funcionar a la perfección en poco tiempo!

¿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