Problemas comunes de PrestaShop en cPanel y cómo solucionarlos

¿Tu tienda PrestaShop se ha vuelto lenta, no carga o muestra un error blanco? No te preocupes. Como técnico de soporte, he visto decenas de estos casos y, en la mayoría de las situaciones, la solución está a unos pocos clics en tu cPanel. En esta guía extensa y práctica, vamos a recorrer los problemas más frecuentes de PrestaShop en cPanel y te daré pasos claros para solucionar PrestaShop sin necesidad de ser un experto en desarrollo.

Vamos paso a paso, como si estuviéramos juntos frente a la pantalla.

1. El temido "Error 500" o pantalla blanca (WSOD)

Este es, con diferencia, el problema más común al solucionar PrestaShop. Puede aparecer después de una actualización, al instalar un módulo o incluso sin razón aparente. La pantalla blanca suele deberse a un aumento del límite de memoria de PHP o a un error en un archivo.

Pasos para resolverlo desde cPanel:

Accede al Administrador de Archivos de cPanel (File Manager). Ve a la carpeta public_html o donde tengas instalado PrestaShop.
Busca el archivo config/defines.inc.php y edítalo.
Localiza la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);.
Guarda el archivo y recarga la tienda. Ahora verás un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size..."). Anota ese error.
Vuelve a poner false cuando termines (por seguridad).

[WARNING] No dejes el modo desarrollo activado en producción, ya que expone información sensible de tu servidor.

Si el error es por memoria:

Desde cPanel, busca "Select PHP Version" o "MultiPHP INI Editor".
Aumenta el valor de memory_limit a 256M o incluso 512M.
También puedes subir max_execution_time a 300 y upload_max_filesize a 64M.

2. PrestaShop no se conecta a la base de datos

Otro clásico. Aparece un mensaje como "Cannot connect to database" o "Error establishing a database connection". Esto suele ocurrir tras mover la tienda a otro hosting, cambiar la contraseña de MySQL o por un error en el archivo de configuración.

¿Cómo solucionarlo?

En cPanel, ve a "Bases de datos MySQL" y verifica que la base de datos y el usuario existan y estén vinculados.
Anota el nombre de la base de datos, el usuario y la contraseña.
En el Administrador de Archivos, edita el archivo app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en versiones antiguas).
Revisa que los valores de database_host, database_name, database_user y database_password coincidan exactamente con los de cPanel.
Si usas un servidor local (localhost), normalmente el host es localhost. Pero si tu hosting usa un servidor remoto, podría ser algo como mysql.tudominio.com.

[TIP] Si acabas de cambiar la contraseña de MySQL en cPanel, actualiza también el archivo de configuración de PrestaShop. Es un error muy común.

3. Problemas con las URLs amigables (mod_rewrite)

Si tus URLs se ven como index.php?id_product=123 en lugar de tutienda.com/zapatos-rojos, el módulo mod_rewrite de Apache no está activo o la configuración de .htaccess está corrupta.

Solución paso a paso:

En cPanel, busca "Apache Handlers" o "Select PHP Version" y asegúrate de que mod_rewrite esté marcado (normalmente viene por defecto).
Ve a Administrador de Archivos y en la raíz de PrestaShop (carpeta public_html), busca el archivo .htaccess (puede estar oculto; activa "Mostrar archivos ocultos").
Si no existe, ve al Back Office de PrestaShop: Configuración → Parámetros de la tienda → Tráfico y SEO y haz clic en "Guardar" sin cambiar nada. Esto regenera el .htaccess.
Si el archivo existe pero está dañado, renómbralo a .htaccess_old y repite el paso anterior.

[INFO] Algunos hosting compartidos desactivan mod_rewrite por seguridad. Si el problema persiste, contacta a tu proveedor y pídeles que lo activen.

4. La tienda carga muy lenta o da timeout

La lentitud en PrestaShop puede deberse a muchas causas: módulos pesados, imágenes sin optimizar, caché desactivada o una versión de PHP obsoleta.

Optimizaciones rápidas desde cPanel:

PHP Version: Asegúrate de usar PHP 8.0 o superior. En cPanel, ve a "Select PHP Version" y elige la más reciente compatible con tu PrestaShop.
Activar la caché de PrestaShop: En el Back Office, ve a Configuración → Rendimiento. Activa "Caché" (recomiendo "Sistema de archivos" o "Redis" si tu hosting lo soporta).
Comprimir imágenes: Usa un módulo de optimización o, desde cPanel, instala ImageMagick en la versión de PHP.
Desactivar módulos innecesarios: Desde el Back Office, en Módulos → Gestor de módulos, desactiva los que no uses.

[WARNING] Si tu hosting tiene recursos muy limitados (por ejemplo, 1 GB de RAM), considera migrar a un plan superior o a un VPS. PrestaShop es exigente.

5. Error "El archivo no se puede subir" al instalar módulos o temas

Esto suele deberse a un límite de tamaño de subida en PHP o a permisos incorrectos en la carpeta modules o themes.

Solución:

En cPanel, ve a "MultiPHP INI Editor" y aumenta:
- upload_max_filesize a 64M
- post_max_size a 64M
- max_execution_time a 300
En el Administrador de Archivos, haz clic derecho en la carpeta modules y selecciona "Cambiar permisos". Pon 755 (o 0755) y marca "Recursivo".
Repite lo mismo con la carpeta themes, override y img.

[TIP] Si el módulo es pesado (más de 20 MB), mejor súbelo por FTP o por el Administrador de Archivos directamente y luego actívalo desde el Back Office.

6. Problemas con SSL / HTTPS forzado

Si tu tienda se ve sin candado o te redirige a HTTP a pesar de tener SSL, probablemente la configuración de PrestaShop o del .htaccess no está correcta.

Pasos para forzar HTTPS desde cPanel:

En cPanel, ve a "SSL/TLS" y asegúrate de que el certificado esté instalado y activo.
En el Back Office de PrestaShop: Configuración → Parámetros de la tienda → Tráfico y SEO. En "URL de la tienda", cambia http:// por https://.
Ve a Configuración → Rendimiento y limpia la caché.
Si usas .htaccess, añade al inicio:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]

[WARNING] No hagas esto si tu certificado SSL no está bien configurado, o los clientes verán un error de seguridad.

7. Preguntas Frecuentes (FAQ PrestaShop)

Aquí respondo las dudas que más me llegan como técnico de soporte.

¿Por qué mi PrestaShop no muestra los productos después de una migración?

Lo más probable es que la base de datos no se haya importado correctamente o que las URLs de las imágenes estén rotas. Revisa que la tabla ps_product tenga registros y regenera las miniaturas desde el Back Office (Configuración → Mantenimiento → Imágenes).

¿Cómo cambio la contraseña de administrador si no recuerdo la anterior?

Desde phpMyAdmin en cPanel, selecciona tu base de datos, busca la tabla ps_employee, edita el registro de tu usuario y cambia el campo passwd por un hash generado con MD5 (por ejemplo, 5f4dcc3b5aa765d61d8327deb882cf99 para "password"). Luego inicia sesión con esa contraseña y cámbiala.

¿Puedo usar Syspanel en lugar de cPanel para gestionar PrestaShop?

Sí, Syspanel (el panel basado en HestiaCP) también es compatible. De hecho, muchos usuarios lo prefieren por su ligereza. Recuerda que el puerto de acceso a Syspanel es el 2106 (ejemplo: tudominio.com:2106). Desde allí puedes gestionar bases de datos, archivos y dominios igual que en cPanel.

¿Por qué aparecen errores de "500 Internal Server Error" después de una actualización de PrestaShop?

Generalmente por incompatibilidad de módulos o temas. Desactiva todos los módulos no nativos desde el Back Office (ve a Módulos → Gestor, y usa el botón "Desactivar todo"). Si no puedes acceder al Back Office, renombra la carpeta modules a modules_old mediante FTP o el Administrador de Archivos, y luego crea una nueva carpeta modules vacía. Luego ve subiendo los módulos esenciales uno por uno.

¿Cómo hago una copia de seguridad de mi tienda desde cPanel?

Ve a "Copias de seguridad" en cPanel.
Descarga la copia completa de la base de datos (formato .sql.gz).
Descarga el contenido de public_html (puedes comprimirlo desde el Administrador de Archivos seleccionando la carpeta y usando "Comprimir").
Guarda ambos archivos en un lugar seguro.

8. Consejo final: Mantén todo actualizado

Para evitar la mayoría de problemas PrestaShop, sigue esta rutina:

PHP: Usa siempre la versión recomendada por PrestaShop (actualmente PHP 8.1 o 8.2).
PrestaShop: Actualiza a la última versión estable apenas salga.
Módulos y temas: Mantenlos actualizados desde el Back Office.
cPanel: Revisa que no haya actualizaciones pendientes en "Actualizaciones de software".

[INFO] Si después de todo esto sigues con problemas, revisa los logs de errores de tu servidor en cPanel (sección "Registros de errores"). Allí suele estar la respuesta definitiva.

Espero que esta guía te haya sido de ayuda. Recuerda que solucionar PrestaShop desde cPanel es cuestión de paciencia y de seguir los pasos en orden. Si algo no funciona, no dudes en preguntar a tu proveedor de hosting o en foros especializados. ¡Tu tienda online volverá a volar pronto!