Errores frecuentes de PrestaShop en DirectAdmin y soluciones

Introducción: ¿Por qué aparecen errores en PrestaShop con DirectAdmin?

PrestaShop es una de las plataformas de comercio electrónico más populares, pero como cualquier software, puede presentar fallos si no se configura correctamente. Cuando tu tienda está alojada en un panel de control como DirectAdmin, algunos errores son muy comunes, especialmente por temas de permisos, versiones de PHP o configuraciones del servidor. En este artículo te explicaré los errores PrestaShop DirectAdmin más frecuentes y cómo solucionar PrestaShop paso a paso, sin necesidad de ser un experto técnico.

[INFO] Si usas Syspanel (antes HestiaCP), recuerda que el acceso es por el puerto 2106. Los pasos son similares, pero adapta las rutas según tu panel.

Error 1: Pantalla blanca o "500 Internal Server Error"

¿Qué significa?

Una pantalla completamente blanca o un error 500 indica que PHP dejó de funcionar sin mostrar detalles. Esto suele pasar por un límite de memoria insuficiente o un error de sintaxis en algún archivo.

Causas comunes en DirectAdmin

Límite de memoria PHP bajo (menos de 128MB).
Módulos PHP desactivados (como curl, json o mbstring).
Archivos con permisos incorrectos (por ejemplo, config/settings.inc.php con permisos 777).

Cómo solucionarlo en DirectAdmin

Accede a DirectAdmin e ingresa a tu cuenta de hosting.
Ve a "Administrador de PHP" (o "PHP Selector").
Aumenta el límite de memoria a 256M o 512M. También verifica que estén activos los módulos: curl, json, mbstring, gd, openssl.
Revisa los permisos de archivos: en DirectAdmin, usa el "Administrador de Archivos" y busca la carpeta config/. El archivo settings.inc.php debe tener permisos 644. Si es 777, cámbialo.
Limpia la caché de PrestaShop: ve a tu panel de administración (si puedes acceder) y en "Parámetros de la tienda > Rendimiento" limpia la caché. Si no puedes, elimina manualmente la carpeta /var/cache/ desde el administrador de archivos.

[WARNING] No borres archivos del core de PrestaShop. Solo limpia la caché o cambia permisos. Si el error persiste, contacta a tu proveedor de hosting.

Error 2: "El archivo no se puede sobrescribir" al actualizar módulos o temas

¿Qué significa?

Este error suele aparecer cuando los permisos de las carpetas modules o themes no permiten escritura. En DirectAdmin, es común que las carpetas tengan permisos demasiado restrictivos.

Causas comunes

Permisos de carpeta modules en 755 o 644 (deberían ser 755 para carpetas y 644 para archivos).
El usuario del servidor no coincide con el propietario de los archivos.
El modo seguro de PHP está activado (aunque en servidores modernos casi no se usa).

Solución paso a paso

En DirectAdmin, ve a "Administrador de Archivos" y navega hasta la raíz de tu tienda.
Selecciona la carpeta modules y haz clic en "Cambiar permisos".
Pon 755 en la casilla de "Permisos numéricos" y marca la opción "Aplicar a subdirectorios".
Repite el proceso con la carpeta themes y también con override y translations.
Luego, en "Configuración PHP", asegúrate de que "open_basedir" no esté restringiendo la carpeta de módulos. Si ves algo como open_basedir = /home/usuario:/tmp, está bien. Si no aparece, pide a tu hosting que lo configure.

[TIP] Si usas Syspanel, el proceso es idéntico, solo que accedes por el puerto 2106 y el administrador de archivos se llama "Archivos".

Error 3: "Error de conexión a la base de datos" o "No se puede conectar a la base de datos"

¿Qué significa?

PrestaShop no puede comunicarse con MySQL/MariaDB. Esto sucede por credenciales incorrectas, servidor de base de datos caído o límites de conexiones.

Causas comunes en DirectAdmin

Contraseña de base de datos cambiada sin actualizar en config/settings.inc.php.
Servidor MySQL reiniciado o con sobrecarga.
Límite de conexiones simultáneas bajo (por ejemplo, 10 conexiones).

Cómo solucionarlo

Verifica las credenciales: en DirectAdmin, ve a "MySQL Management" y anota el nombre de la base de datos, usuario y contraseña.
Abre el archivo config/settings.inc.php (en la raíz de tu tienda) y comprueba que los valores coincidan exactamente. Si no, edítalos con un editor de texto.
Reinicia MySQL: desde DirectAdmin, en "Servicios" > "MySQL", haz clic en "Reiniciar".
Aumenta el límite de conexiones: si tienes acceso a "Configuración de MySQL" (en algunos planes compartidos no), cambia max_connections a 50 o 100. Si no, pide a tu hosting.

[WARNING] Nunca compartas la contraseña de tu base de datos en foros públicos. Si sospechas que fue comprometida, cámbiala desde DirectAdmin.

Error 4: "El módulo no se puede instalar" o "Error al cargar el módulo"

¿Qué significa?

Al intentar instalar un módulo (gratuito o de pago), PrestaShop muestra un error. Esto suele deberse a archivos corruptos, falta de permisos o incompatibilidad de versiones.

Causas comunes

Módulo descargado incompleto (por ejemplo, por cortes de internet).
Permisos incorrectos en la carpeta modules (ya vimos cómo solucionarlo).
PHP versión incompatible (PrestaShop 1.7 requiere PHP 7.1+; 8.0+ es mejor).

Solución

Verifica la versión de PHP: en DirectAdmin, ve a "PHP Selector" y asegúrate de tener PHP 7.4 o 8.0 (según tu versión de PrestaShop).
Reinstala el módulo: descárgalo nuevamente desde la fuente oficial. Luego, súbelo por "Administrador de Archivos" o por FTP a la carpeta modules.
Activa el modo debug: en el archivo config/defines.inc.php, cambia _PS_MODE_DEV_ de false a true. Así verás el error exacto. No olvides revertirlo después.
Revisa los logs: en DirectAdmin, ve a "Logs de errores" (dentro de "Estadísticas") y busca líneas con "PrestaShop" o "PHP". Copia el error y búscalo en Google.

[INFO] Si el módulo es de pago, contacta al desarrollador. A veces los módulos requieren extensiones PHP específicas como soap o zip.

Error 5: "404 Página no encontrada" en todas las páginas excepto la principal

¿Qué significa?

Las URLs amigables no funcionan. Esto es típico si el archivo .htaccess no se generó correctamente o si el módulo mod_rewrite de Apache está desactivado.

Causas comunes en DirectAdmin

Archivo .htaccess corrupto o faltante.
mod_rewrite desactivado en el servidor.
URLs amigables mal configuradas en PrestaShop.

Cómo solucionarlo

Regenera el .htaccess: en tu panel de administración de PrestaShop, ve a "Parámetros de la tienda > Tráfico y SEO" y haz clic en "Guardar" (sin cambiar nada). Esto regenera el archivo.
Verifica que mod_rewrite esté activo: en DirectAdmin, ve a "Configuración de Apache" (o "Apache Management") y busca "mod_rewrite". Si no aparece, pide a tu hosting que lo active.
Comprueba el .htaccess manualmente: si no puedes acceder al panel, descarga el archivo .htaccess desde el administrador de archivos. Busca la línea RewriteEngine On. Si no está, añádela.
Si usas Syspanel: el proceso es el mismo, pero el acceso a Apache está en "Servicios Web".

[TIP] Si el error persiste, desactiva las URLs amigables temporalmente desde la base de datos (en la tabla ps_configuration, busca PS_REWRITING_SETTINGS y pon 0). Luego vuelve a activarlas.

Error 6: "El carrito no se actualiza" o "No se pueden añadir productos"

¿Qué significa?

El carrito de compras deja de funcionar. Esto suele deberse a problemas con las cookies de sesión o con la configuración del servidor.

Causas comunes

Cookies mal configuradas (dominio no coincide con el de la tienda).
Sesiones de PHP corruptas.
Redirección a HTTPS forzada pero sin certificado SSL.

Solución

Limpia las cookies del navegador (en el cliente) y prueba en modo incógnito.
Verifica la URL de la tienda: en PrestaShop, ve a "Parámetros de la tienda > General" y asegúrate de que la URL base tenga https:// si usas SSL.
Activa el modo debug (como explicamos antes) para ver si hay errores de JavaScript o PHP.
Revisa los logs de sesión: en DirectAdmin, busca en "Logs de errores" mensajes como "session_start()". Si ves muchos, el problema es del servidor. Pide a tu hosting que aumente el límite de sesiones.

[WARNING] Si usas un CDN como Cloudflare, desactiva "Rocket Loader" temporalmente, ya que puede interferir con JavaScript de PrestaShop.

Preguntas frecuentes (FAQ)

¿Puedo solucionar estos errores sin conocimientos técnicos?

Sí, la mayoría de los pasos aquí descritos son accesibles desde el panel de DirectAdmin. Si tienes dudas, siempre puedes contactar al soporte de tu hosting.

¿Por qué es importante actualizar PHP?

PrestaShop 1.7 no funciona bien con PHP 5.6 o inferior. Además, versiones antiguas de PHP tienen vulnerabilidades de seguridad. DirectAdmin te permite cambiar la versión fácilmente.

¿Qué hago si después de seguir los pasos el error persiste?

Revisa los logs de error de DirectAdmin (en "Estadísticas > Logs de errores") y busca el mensaje exacto. Luego, puedes buscar en foros como PrestaShop Community o contactar a un desarrollador.

¿Syspanel (HestiaCP) es igual que DirectAdmin para estos errores?

Sí, los principios son los mismos. La diferencia es que en Syspanel accedes por el puerto 2106 y algunas herramientas se llaman diferente (por ejemplo, "Archivos" en lugar de "Administrador de Archivos"). Los pasos de permisos y PHP son equivalentes.

Conclusión

Los errores PrestaShop DirectAdmin son comunes pero casi siempre tienen solución. Ya sea por permisos, configuraciones de PHP o problemas con la base de datos, con los pasos de esta guía podrás solucionar PrestaShop sin estrés. Recuerda siempre hacer copias de seguridad antes de modificar archivos críticos y mantener tu tienda actualizada.

Si te ha sido útil, comparte este artículo con otros usuarios de PrestaShop. ¡Buena suerte con tu tienda online!