Errores comunes en PrestaShop con cPanel y cómo solucionarlos

Errores Comunes de PrestaShop en cPanel y Cómo Solucionarlos

Si tienes una tienda online con PrestaShop y la gestionas a través de cPanel, es probable que en algún momento te encuentres con algún error. No te preocupes, es algo habitual y la mayoría de problemas tienen una solución sencilla. En esta guía, vamos a repasar los errores PrestaShop cPanel más frecuentes y te daremos pasos claros para solucionar problemas PrestaShop sin necesidad de ser un experto técnico.

[INFO] Este artículo está pensado para usuarios que administran su hosting con cPanel o sistemas similares. Si usas Syspanel, recuerda que el puerto de acceso es el 2106, pero los pasos para solucionar estos errores son prácticamente los mismos.

Vamos a empezar por lo más básico y subiremos el nivel poco a poco, para que puedas seguir cada paso con confianza.

¿Por Qué Aparecen Errores en PrestaShop?

PrestaShop es un sistema muy potente, pero también depende de muchos factores: la configuración del servidor, los módulos instalados, la versión de PHP, los permisos de archivos, la memoria disponible, etc. Un cambio pequeño, como una actualización de módulo o un ajuste en cPanel, puede desencadenar un error. Lo bueno es que, con un enfoque metódico, casi siempre puedes identificar y resolver el problema.

1. El Error del "500 Internal Server Error"

Este es, sin duda, uno de los errores PrestaShop cPanel más temidos. La página se queda en blanco o muestra un mensaje genérico de error interno. Las causas pueden ser varias, pero las más comunes son:

Un archivo .htaccess corrupto.
Un módulo que está dando problemas.
Límites de memoria PHP insuficientes.
Permisos de archivos incorrectos.

Pasos para solucionarlo:

Accede a cPanel y ve al "Administrador de Archivos". Busca la carpeta raíz de tu tienda PrestaShop (normalmente public_html).
Localiza el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Renombra el archivo a .htaccess_backup. Esto desactivará temporalmente las reglas de reescritura de URL.
Prueba tu tienda. Si el error desaparece, el problema está en ese archivo. Puedes generar uno nuevo desde el panel de administración de PrestaShop (Parámetros de la tienda > Tráfico y SEO > SEO y URLs > botón "Guardar" para regenerar).
Si el error persiste, toca revisar el error log. En cPanel, busca la sección "Errores" o "Error Log". Ahí verás la línea exacta que causa el problema (por ejemplo, un módulo conflictivo).
Desactiva módulos uno por uno. Si el log apunta a un módulo, renombra su carpeta dentro de /modules (por ejemplo, /modules/nombre_modulo_bak) para desactivarlo forzosamente.

[WARNING] Antes de hacer cambios, siempre es recomendable hacer una copia de seguridad de tu tienda y la base de datos. Un pequeño error puede dejarte la tienda fuera de servicio.

2. El Molesto Error de "Tiempo de Ejecución Excedido"

¿Te aparece un mensaje como "Fatal error: Maximum execution time of 30 seconds exceeded"? Esto significa que un script de PrestaShop está tardando más de lo permitido. Es muy común al instalar módulos, importar productos o durante procesos pesados.

Soluciones prácticas:

Aumenta el límite de tiempo desde cPanel: Busca la sección "Seleccionar versión de PHP" o "MultiPHP INI Editor". Ahí podrás modificar el valor max_execution_time. Ponlo a 120 o 180 segundos.
Modifica el archivo php.ini: Si no tienes acceso al editor, puedes crear o editar un archivo php.ini en la raíz de tu tienda con la línea: max_execution_time = 180.
Optimiza el proceso: Si el error ocurre siempre al hacer una tarea específica (como importar un CSV), prueba a dividir el archivo en partes más pequeñas.

3. Error de "Permiso Denegado" al Subir Archivos

Este error suele ir acompañado de un mensaje como "Unable to write in cache folder" o "Cannot write to file". Es un problema de permisos. PrestaShop necesita escribir en ciertas carpetas (como cache, log, upload, img) para funcionar correctamente.

Cómo arreglarlo desde cPanel:

Ve al "Administrador de Archivos".
Selecciona la carpeta raíz de tu tienda.
Haz clic en "Permisos" en la barra superior.
Establece los permisos recomendados:
- Carpetas: 755 (o 755 para que sea seguro).
- Archivos: 644.
- La carpeta config y el archivo settings.inc.php deben tener permisos 444 (solo lectura) después de la instalación.
Aplica los cambios recursivamente (marca la casilla "Cambiar permisos a subcarpetas").

[TIP] No pongas nunca permisos 777 en producción. Aunque soluciona el error temporalmente, deja tu tienda expuesta a ataques.

4. El Error de "Base de Datos No Conectada"

Si ves algo como "Cannot connect to database" o "Error de conexión a la base de datos", el problema está en los datos de conexión. Puede ser que hayas cambiado la contraseña de la base de datos en cPanel, o que el archivo settings.inc.php tenga información incorrecta.

Pasos para resolverlo:

Accede a cPanel y ve a "Bases de Datos MySQL". Comprueba que la base de datos y el usuario existen.
Verifica la contraseña. Si la has cambiado, asegúrate de que el usuario de la base de datos tenga la contraseña actualizada.
Edita el archivo settings.inc.php. Está en la carpeta config de tu PrestaShop. Busca las líneas _DB_SERVER_, _DB_NAME_, _DB_USER_ y _DB_PASSWD_ y asegúrate de que coincidan con los datos de tu base de datos en cPanel.

5. Pantalla en Blanco o "White Screen of Death"

Este es otro de los clásicos errores PrestaShop cPanel. La página no carga nada, solo un fondo blanco. Las causas suelen ser:

PHP con errores fatales (por ejemplo, por un módulo incompatible).
Límite de memoria PHP agotado.
Archivos de caché corruptos.

Solución paso a paso:

Activa el modo depuración de PrestaShop. Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Esto mostrará el error específico en lugar de la pantalla en blanco.
Una vez veas el error, actúa en consecuencia:
- Si es un error de memoria, aumenta memory_limit en el MultiPHP INI Editor (ponlo a 256M o 512M).
- Si es un error de un módulo, desactívalo forzosamente (recuerda, renombrando su carpeta).
Limpia la caché de PrestaShop. Desde el panel de administración, ve a "Parámetros de la tienda > Rendimiento" y haz clic en "Limpiar caché". Si no puedes acceder al panel, elimina manualmente el contenido de la carpeta /cache/smarty/cache y /cache/smarty/compile (no borres las carpetas, solo su contenido).

6. Error al Instalar o Actualizar un Módulo

Es muy frustrante, ¿verdad? A veces, al intentar instalar un módulo desde el mercado de PrestaShop o subiendo un archivo ZIP, aparece un error de conexión o de permisos.

Posibles causas y soluciones:

Falta de permisos en la carpeta modules: Asegúrate de que tenga permisos 755.
Problema de conexión con el mercado de PrestaShop: Puede ser un bloqueo temporal. Prueba más tarde o usa la opción de subir el módulo manualmente.
Versión de PHP incompatible: Algunos módulos requieren PHP 7.4 o 8.0. Verifica la versión en cPanel (Seleccionar versión de PHP) y cámbiala si es necesario.
Límite de subida de archivos (upload_max_filesize): Si el módulo es muy pesado, aumenta este valor en el MultiPHP INI Editor (por ejemplo, a 64M).

7. Errores de URL Amigables o "404 Not Found"

Si tus productos no se ven o te dan error 404, es probable que las URLs amigables no estén funcionando bien. Esto suele pasar después de migrar la tienda o cambiar de servidor.

Cómo solucionarlo:

Regenera el archivo .htaccess: Ve a "Parámetros de la tienda > Tráfico y SEO > SEO y URLs" y haz clic en "Guardar" sin cambiar nada. Esto regenera el archivo.
Verifica que el módulo mod_rewrite esté activo en cPanel. Si no lo ves, contacta a tu proveedor de hosting.
Si usas Syspanel, el proceso es el mismo, pero recuerda que el acceso es por el puerto 2106. Busca la opción de reescribir URLs en la configuración del sitio.

8. El Error de "Espacio en Disco Insuficiente"

PrestaShop necesita espacio para imágenes, logs, caché, etc. Si tu hosting se llena, pueden aparecer errores extraños.

Diagnóstico y solución:

Revisa el uso del disco en cPanel (sección "Estadísticas" o "Uso del disco").
Limpia la carpeta de logs: Ve a /var/logs o /log dentro de tu PrestaShop y elimina archivos antiguos.
Optimiza las imágenes: Usa módulos de compresión de imágenes para reducir su peso.
Considera aumentar tu plan de hosting si el problema es recurrente.

9. Errores de Caché y Rendimiento

Una tienda lenta o con errores de caché puede ser un dolor de cabeza. Los síntomas típicos son: cambios que no se ven en la tienda, productos que no se actualizan, o mensajes de "caché corrupta".

Soluciones:

Limpia la caché desde el panel de administración (Parámetros de la tienda > Rendimiento > Limpiar caché).
Desactiva la caché de Smarty temporalmente para pruebas (en la misma sección, pon "No usar caché").
Si usas un CDN o caché de servidor (como Varnish), purga su caché desde cPanel. Busca la sección "Varnish" o "Cache" y haz clic en "Purgar todo".

10. Problemas con el Certificado SSL

Si tu tienda muestra un mensaje de "No seguro" o errores de contenido mixto, el SSL no está bien configurado.

Pasos para solucionarlo:

Asegúrate de tener un certificado SSL instalado en cPanel (sección "SSL/TLS").
Fuerza el HTTPS en PrestaShop: Ve a "Parámetros de la tienda > Tráfico y SEO > SEO y URLs" y activa la opción "Forzar HTTPS".
Revisa que todas las imágenes y recursos se carguen por HTTPS. Puedes usar herramientas online como "SSL Checker" o el inspector de tu navegador para detectar contenido mixto.

Preguntas Frecuentes (FAQ) sobre Errores PrestaShop cPanel

P: ¿Qué hago si no puedo acceder al panel de administración de PrestaShop?
R: Si el panel no carga, prueba a acceder directamente con la URL /admin1234 (sustituye "admin1234" por tu carpeta real). Si tampoco funciona, activa el modo depuración (cambia _PS_MODE_DEV_ a true en config/defines.inc.php) para ver el error exacto. También puedes desactivar módulos desde cPanel renombrando carpetas.

P: ¿Cómo restauro mi tienda desde una copia de seguridad en cPanel?
R: En cPanel, ve a "Copias de seguridad" o "Backup". Puedes descargar una copia completa de tu sitio y base de datos. Para restaurar, usa la opción "Restaurar una copia de seguridad parcial" o, si es completa, sube los archivos por FTP y restaura la base de datos desde phpMyAdmin.

P: ¿Por qué mi tienda se vuelve lenta después de instalar un módulo?
R: Puede que el módulo no esté optimizado o consuma muchos recursos. Prueba a desactivarlo y ver si la velocidad mejora. Si es esencial, contacta al desarrollador del módulo. También revisa que tu hosting tenga suficientes recursos (memoria, CPU).

P: ¿Es seguro usar permisos 777 para solucionar errores de escritura?
R: No, nunca. Los permisos 777 son un grave riesgo de seguridad. Siempre usa 755 para carpetas y 644 para archivos. Si PrestaShop necesita escribir, asegúrate de que el usuario del servidor tenga permisos adecuados sin llegar a 777.

P: ¿Qué hago si el error "500 Internal Server Error" sigue apareciendo después de seguir todos los pasos?
R: Revisa a fondo el error log de cPanel. Busca la línea exacta que falla. Si es un problema de un módulo, desactívalo. Si es un error de PHP, cambia la versión de PHP desde cPanel (prueba con PHP 7.4 o 8.0). Si nada funciona, contacta al soporte técnico de tu hosting.

Conclusión

Los errores PrestaShop cPanel pueden ser frustrantes, pero con un enfoque metódico y las herramientas adecuadas, casi todos tienen solución. Recuerda siempre hacer copias de seguridad antes de hacer cambios importantes, y no dudes en consultar los logs de error, que son tu mejor aliado para diagnosticar problemas.

[TIP] Si usas Syspanel (puerto 2106), los pasos son prácticamente idénticos. Solo cambia la interfaz, pero los conceptos de permisos, PHP, bases de datos y caché son los mismos.

Esperamos que esta guía te haya sido de ayuda. Si tienes alguna duda o te encuentras con un error que no está en esta lista, no dudes en dejar un comentario. ¡Tu tienda online volverá a funcionar en poco tiempo!