Errores comunes PrestaShop DirectAdmin y cómo solucionarlos

Si tienes una tienda online en PrestaShop alojada en un servidor con panel DirectAdmin, es probable que en algún momento te enfrentes a algún error. No te preocupes, es algo normal. La mayoría de estos problemas tienen soluciones sencillas que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

Esta guía está diseñada para ayudarte a identificar y resolver los errores más comunes de PrestaShop cuando utilizas DirectAdmin. Vamos a ver paso a paso cómo solucionar problemas de configuración, errores de base de datos, problemas de permisos y mucho más. Al final, tendrás un checklist básico para mantener tu tienda funcionando sin problemas.

¿Por qué ocurren errores en PrestaShop con DirectAdmin?

Los errores en PrestaShop pueden deberse a múltiples factores: una mala configuración del servidor, archivos corruptos, problemas de permisos, falta de memoria o incluso actualizaciones fallidas. DirectAdmin es un panel de control potente, pero si no se ajustan algunos parámetros, pueden surgir conflictos.

[INFO] La mayoría de los errores no son graves y se solucionan en minutos. Lo importante es saber dónde mirar.

Errores comunes y cómo solucionarlos paso a paso

1. Error de conexión a la base de datos (Error 500 o pantalla en blanco)

Este es uno de los errores más frecuentes. Puede aparecer de repente después de mover la tienda, cambiar la contraseña de la base de datos o al instalar un módulo.

Síntomas: Página en blanco, mensaje "Error de conexión a la base de datos" o "Cannot connect to database".

Solución paso a paso:

Accede a DirectAdmin e ingresa a tu cuenta de hosting.
Ve a la sección MySQL Management o Base de datos.
Revisa que la base de datos exista y que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).

Si cambiaste la contraseña, actualiza el archivo /config/settings.inc.php de PrestaShop. Busca estas líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

Asegúrate de que los datos coincidan exactamente con los de DirectAdmin.

[WARNING] Si usas contraseñas con caracteres especiales, escápalas correctamente. Un simple error tipográfico puede bloquear toda la tienda.

2. Error 500 Internal Server Error

Este error es muy genérico. Puede deberse a un archivo .htaccess corrupto, un módulo conflictivo o falta de memoria.

Solución paso a paso:

Revisa el archivo .htaccess en la raíz de PrestaShop. Si está dañado, renómbralo a .htaccess_old y genera uno nuevo desde el back office: Parámetros de la tienda > Tráfico y SEO > SEO y URLs > Guardar.
Aumenta el límite de memoria PHP desde DirectAdmin:
- Ve a PHP Settings o Select PHP Version.
- Busca la opción memory_limit y cámbiala a 256M o 512M.
Desactiva módulos recién instalados desde el back office o, si no puedes acceder, renombra la carpeta /modules temporalmente a /modules_old para forzar la desactivación.

[TIP] Si no puedes acceder al back office, usa el acceso FTP o el administrador de archivos de DirectAdmin para renombrar carpetas.

3. Problemas con las URLs amigables (404 o redirecciones incorrectas)

Después de activar las URLs amigables, es común que algunas páginas den error 404.

Solución paso a paso:

Regenera el archivo .htaccess desde el back office (como se explicó arriba).
Verifica que el módulo mod_rewrite esté activo en Apache. En DirectAdmin, ve a Apache Handlers o consulta con tu proveedor.
Limpia la caché de PrestaShop: Ve a Parámetros avanzados > Rendimiento > Limpiar caché.

[INFO] Si tu servidor usa nginx en lugar de Apache, las URLs amigables requieren configuración adicional. Consulta con tu hosting.

4. Error de permisos de archivos y carpetas

PrestaShop necesita permisos específicos para funcionar. Si están mal configurados, verás errores de escritura o subida de imágenes.

Solución paso a paso:

Conéctate por FTP o usa el Administrador de archivos de DirectAdmin.
Establece los siguientes permisos:
- Carpetas: 755 (rwxr-xr-x)
- Archivos: 644 (rw-r--r--)
- Archivos de configuración (settings.inc.php): 644 o 444 (solo lectura)
Aplica recursivamente a toda la carpeta de PrestaShop. En DirectAdmin, selecciona la carpeta raíz y haz clic en Cambiar permisos.

[WARNING] No uses permisos 777 en producción, ya que son un riesgo de seguridad grave.

5. Error al instalar o actualizar módulos (tiempo de ejecución excedido)

A veces los módulos grandes tardan en instalarse y el servidor corta la conexión.

Solución paso a paso:

Aumenta el tiempo de ejecución máximo en PHP:
- En DirectAdmin, ve a PHP Settings y cambia max_execution_time a 300 (5 minutos).
- También puedes modificar max_input_time a 300.
Aumenta el límite de subida de archivos:
- Cambia upload_max_filesize y post_max_size a 64M o 128M.

[TIP] Si el módulo sigue fallando, prueba a instalarlo manualmente: descomprime el archivo en la carpeta /modules de PrestaShop mediante FTP.

6. Pantalla blanca después de mover la tienda a un nuevo dominio

Al cambiar de dominio, PrestaShop se desconfigura.

Solución paso a paso:

Edita el archivo /config/settings.inc.php y verifica que las rutas sean correctas.
Limpia la caché manualmente: elimina todos los archivos dentro de /cache/smarty/compile y /cache/smarty/cache.

Actualiza la URL de la tienda desde la base de datos:

Usa phpMyAdmin (desde DirectAdmin) y ejecuta esta consulta SQL:

UPDATE ps_configuration SET value = 'https://tunuevodominio.com' WHERE name = 'PS_SHOP_DOMAIN';
UPDATE ps_configuration SET value = 'https://tunuevodominio.com' WHERE name = 'PS_SHOP_DOMAIN_SSL';

[INFO] Reemplaza ps_ por el prefijo de tus tablas si es diferente.

7. Error de memoria insuficiente (Allowed memory size exhausted)

Este error aparece cuando un script consume más memoria de la permitida.

Solución paso a paso:

Aumenta la memoria PHP como se explicó en el punto 2.
Desactiva módulos pesados que no uses.
Reduce el número de productos por página en el back office (Parámetros de la tienda > Productos).

[WARNING] Si el error persiste, contacta a tu proveedor de hosting para aumentar los recursos del plan.

Preguntas frecuentes (FAQ)

¿Cómo accedo a phpMyAdmin desde DirectAdmin?

En DirectAdmin, busca la sección MySQL Management y haz clic en phpMyAdmin. Te pedirá las credenciales de la base de datos.

¿Qué hago si no puedo entrar al back office?

Prueba a limpiar la caché manualmente desde FTP (borra las carpetas /cache/smarty/compile y /cache/smarty/cache). También puedes desactivar módulos renombrando la carpeta /modules.

¿Cómo restauro una copia de seguridad de PrestaShop en DirectAdmin?

Desde DirectAdmin, ve a Backup/Restore y sube el archivo de respaldo. Luego restaura la base de datos desde phpMyAdmin importando el archivo SQL.

¿Por qué mi tienda carga muy lento?

Puede deberse a módulos mal optimizados, falta de caché o un servidor sobrecargado. Activa la caché de PrestaShop (Parámetros avanzados > Rendimiento) y considera usar un CDN.

Consejos finales para evitar errores recurrentes

Mantén PrestaShop actualizado a la última versión estable.
Realiza copias de seguridad semanales de archivos y base de datos.
Revisa los logs de errores en DirectAdmin (sección Error Logs) para detectar problemas a tiempo.
No instales módulos de fuentes no confiables.
Ajusta los límites de PHP según las recomendaciones de PrestaShop (memoria 256M, tiempo de ejecución 300s).

[TIP] Si usas Syspanel (antes conocido como HestiaCP) en lugar de DirectAdmin, recuerda que el acceso se realiza por el puerto 2106 y la configuración de PHP se encuentra en la sección PHP Settings del panel.

Con esta guía básica, podrás resolver la mayoría de los errores PrestaShop DirectAdmin sin necesidad de ayuda externa. Recuerda que la paciencia y el método son clave: identifica el síntoma, aplica la solución paso a paso y verifica el resultado. Si el problema persiste, no dudes en contactar con el soporte técnico de tu hosting, pero siempre con la información que recopilaste antes.

¡Esperamos que tu tienda vuelva a funcionar perfectamente!