Solucionar errores PrestaShop en cPanel | Guía de problemas

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

Si estás leyendo esto, probablemente te has topado con algún mensaje de error en tu tienda PrestaShop y no sabes por dónde empezar. No te preocupes, es algo muy común. PrestaShop es una plataforma potente, pero a veces puede dar problemas de configuración, sobre todo si gestionas tu hosting a través de cPanel (o su alternativa Syspanel, que usa el puerto 2106). Los errores PrestaShop cPanel suelen deberse a permisos de archivos, límites de memoria, bases de datos mal configuradas o extensiones desactualizadas.

En esta guía te voy a enseñar a solucionar problemas PrestaShop paso a paso, con un lenguaje muy sencillo. No necesitas ser un experto técnico: solo sigue las instrucciones y verás cómo tu tienda vuelve a funcionar. Al final, también incluyo una sección de preguntas frecuentes para resolver dudas rápidas.

1. Error "500 Internal Server Error" en PrestaShop

Este es uno de los errores comunes PrestaShop cPanel más frustrantes porque no da detalles. Pero no te asustes: suele deberse a un archivo .htaccess corrupto o a un plugin que falla.

Cómo solucionarlo:

Accede a tu cPanel (o a Syspanel desde el puerto 2106).
Ve al Administrador de archivos (File Manager) y navega hasta la carpeta raíz de tu tienda (normalmente public_html).
Busca el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Renómbralo a .htaccess_old (esto lo desactiva temporalmente).
Recarga tu tienda. Si funciona, el problema está en ese archivo. Puedes regenerarlo desde el panel de administración de PrestaShop: ve a Parámetros de la tienda > Tráfico y SEO > URL amigables y haz clic en "Guardar" (esto recrea el .htaccess).
Si el error persiste, desactiva todos los módulos desde el panel de administración (o renombra la carpeta /modules a /modules_old para forzar la desactivación). Luego ve activando uno por uno hasta encontrar el culpable.

[WARNING] Si renombras la carpeta /modules, algunos temas pueden fallar. Hazlo solo como prueba temporal.

2. Error "No se puede conectar a la base de datos"

Este error suele aparecer cuando cambias de hosting o restauras una copia de seguridad. La base de datos no encuentra los datos correctos.

Pasos para solucionarlo:

Entra a cPanel y busca la sección Bases de datos MySQL.
Verifica que tu base de datos y usuario existan y estén vinculados. Si no, créalos de nuevo.
Edita el archivo /app/config/parameters.php en la raíz de tu PrestaShop.

Busca estas líneas y asegúrate de que coincidan con tus credenciales reales:

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Guarda los cambios y recarga la tienda.

[TIP] En Syspanel (puerto 2106), el proceso es similar: busca "Bases de datos" en el menú principal. A veces el host no es "localhost" sino una dirección IP, revísalo en los datos de tu hosting.

3. Error "No se puede escribir en la carpeta /cache"

PrestaShop necesita permisos de escritura en varias carpetas para funcionar. Si ves este error, es un problema de permisos.

Solución:

Desde cPanel, ve al Administrador de archivos.
Selecciona la carpeta raíz de tu tienda y haz clic en Cambiar permisos (o Permissions).
Aplica permisos 755 a las carpetas y 644 a los archivos. Si tienes dudas, usa la opción "Establecer permisos de forma recursiva" para aplicar a todas las subcarpetas.
Las carpetas que necesitan permisos especiales (777) son:
- /cache
- /log
- /img
- /modules
- /themes
- /upload
- /download
- /translations
Si usas Syspanel, el procedimiento es idéntico, solo cambia la interfaz.

[INFO] No pongas 777 en todas las carpetas por seguridad. Solo en las que PrestaShop necesita escribir. Si tu hosting tiene PHP como usuario, a veces basta con 755.

4. Error "Límite de memoria excedido" (Memory Limit)

Este error aparece cuando PrestaShop consume más memoria de la permitida por tu servidor. Es muy común en tiendas con muchos productos o módulos pesados.

Cómo aumentarlo:

Desde cPanel, busca la opción Selector de PHP o MultiPHP INI Editor.
Busca la línea memory_limit y cámbiala a un valor más alto, por ejemplo 256M o 512M.
Guarda los cambios y reinicia el servicio PHP si te lo pide.
Si no tienes acceso a esa opción, puedes editar el archivo .htaccess en la raíz y añadir esta línea:
```
php_value memory_limit 256M
```
También puedes crear un archivo php.ini en la raíz con el mismo contenido.

[WARNING] Si tu hosting es muy básico, puede que no permita aumentar la memoria. En ese caso, contacta con tu proveedor o considera migrar a un plan superior.

5. Error "La página no carga correctamente" (White Screen of Death)

A veces la pantalla se queda en blanco sin ningún mensaje. Esto suele deberse a un error de PHP oculto.

Pasos para diagnosticar:

Activa el modo debug de PrestaShop editando el archivo /config/defines.inc.php.
Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a true.

También añade justo debajo:

define('_PS_DISPLAY_COMPATIBILITY_WARNING_', true);
ini_set('display_errors', 1);

Recarga la página y verás el error real. Suele ser un problema de un módulo o tema.
Si ves un error de tipo "Class not found", es probable que falte un archivo o tengas que reinstalar PrestaShop.
Una vez solucionado, vuelve a poner false en el modo dev por seguridad.

[TIP] No dejes el modo debug activo en producción, ya que expone información sensible.

6. Error "El módulo no se puede instalar" o "El módulo da error 500"

Los módulos son una fuente común de errores PrestaShop cPanel. Si al instalar uno nuevo todo se rompe, sigue estos pasos:

Solución:

Desactiva el módulo desde el panel de administración (si puedes acceder). Si no, renombra la carpeta del módulo en /modules desde el Administrador de archivos.
Verifica la compatibilidad: asegúrate de que el módulo es para tu versión de PrestaShop.
Aumenta el límite de ejecución de PHP (en cPanel, busca "max_execution_time" y ponlo a 300).
Limpia la caché de PrestaShop: ve a Parámetros avanzados > Rendimiento y haz clic en "Limpiar caché".
Si el módulo sigue fallando, revisa los logs de error en la carpeta /log o en cPanel (sección "Errores" o "Error log").

[INFO] En Syspanel (puerto 2106), los logs de error los encuentras en la sección "Registros" del panel.

7. Error "No se puede acceder al panel de administración"

A veces el front-end funciona pero el back-end (admin) da error. Esto suele ser por un problema de URL o de permisos.

Cómo arreglarlo:

Verifica la URL de administración: si cambiaste de dominio, edita el archivo /config/settings.inc.php (en versiones antiguas) o /app/config/parameters.php y actualiza las rutas.
Limpia la caché del navegador o prueba en modo incógnito.
Revisa los permisos de la carpeta /admin (debe ser 755).
Si el error es "Acceso denegado", puede que tu IP esté bloqueada. Desde cPanel, revisa el Administrador de IP o el firewall (como ConfigServer Security & Firewall).
Como último recurso, renombra la carpeta /admin a otro nombre (por ejemplo /admin123) y actualiza la URL en los archivos de configuración.

[WARNING] No compartas la URL de tu admin. Usa un nombre único y difícil de adivinar.

8. Error "No se pueden enviar correos" (problemas con SMTP)

PrestaShop necesita enviar correos para confirmaciones de pedido. Si no funcionan, prueba esto:

Solución:

En el panel de administración, ve a Parámetros avanzados > Correo electrónico.
Cambia el método de envío a SMTP y configura:
- Servidor: mail.tudominio.com o el que te dé tu hosting.
- Usuario y contraseña: los de tu cuenta de correo.
- Puerto: 587 (con TLS) o 465 (con SSL).
Haz clic en "Enviar un correo de prueba".
Si falla, verifica que tu hosting permita envíos SMTP. Algunos bloquean el puerto 25. Usa el puerto 587.
También puedes probar con un servicio externo como Gmail SMTP o SendGrid.

[TIP] En Syspanel, los correos se configuran desde la sección "Correo electrónico" del panel principal.

9. Error "La tienda está en modo mantenimiento" sin razón

A veces PrestaShop se queda atascado en modo mantenimiento aunque lo desactives.

Cómo salir:

Desde cPanel, ve al Administrador de archivos y abre la carpeta /config.
Busca el archivo defines.inc.php y edítalo.
Busca la línea define('_PS_MAINTENANCE_TASK_', false); y cámbiala a true (o viceversa). Guarda.
También puedes forzar el cierre desde la base de datos: con phpMyAdmin, busca la tabla ps_configuration y cambia el valor de PS_SHOP_ENABLE a 1.
Limpia la caché y recarga.

[INFO] Si el problema persiste, puede que un módulo esté forzando el modo mantenimiento. Desactiva todos los módulos temporalmente.

10. Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop da error después de migrar a otro hosting?

Es muy común. Los errores PrestaShop cPanel después de una migración suelen deberse a:

Cambio en la URL de la tienda (hay que actualizarla en la base de datos).
Permisos de archivos incorrectos.
Versión de PHP incompatible (PrestaShop 1.6 necesita PHP 5.6, 1.7 necesita PHP 7.1+).
Base de datos no importada correctamente.

¿Cómo sé qué versión de PHP usa mi cPanel?

En cPanel, busca "Selector de PHP" o "MultiPHP Manager". Allí verás la versión actual. En Syspanel (puerto 2106), está en "PHP Settings".

¿Puedo usar HTTPS sin problemas?

Sí, pero asegúrate de:

Tener un certificado SSL instalado (desde cPanel, en "SSL/TLS").
Configurar PrestaShop para que use HTTPS en Parámetros de la tienda > Tráfico y SEO > URL amigables.
Forzar HTTPS desde el .htaccess.

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

Prueba a restaurar una copia de seguridad de la base de datos y los archivos. Si no tienes, contacta con tu hosting. En Syspanel (puerto 2106), puedes restaurar desde la sección "Copias de seguridad".

¿Es normal que PrestaShop consuma muchos recursos?

Sí, sobre todo si tienes muchos productos, módulos o visitas. Para optimizar:

Activa la caché (en Parámetros avanzados > Rendimiento).
Usa un CDN.
Minimiza el uso de módulos pesados.
Aumenta la memoria PHP (como vimos antes).

Conclusión

Los errores PrestaShop cPanel pueden ser molestos, pero con esta guía tienes las herramientas para solucionar problemas PrestaShop tú mismo. Recuerda siempre hacer copias de seguridad antes de hacer cambios importantes. Si usas Syspanel (puerto 2106), los pasos son muy similares, solo cambia la interfaz.

¿Sigues teniendo problemas? No dudes en contactar con el soporte de tu hosting o con la comunidad de PrestaShop. ¡Tu tienda volverá a funcionar en poco tiempo!

[INFO] Esta guía cubre los errores comunes PrestaShop cPanel más frecuentes. Si encuentras un error no listado, busca en los logs de cPanel o Syspanel para obtener más pistas.