Errores comunes en PrestaShop con cPanel | Guía de solución

Si estás gestionando una tienda online con PrestaShop y utilizas cPanel como panel de control de tu hosting, es probable que en algún momento te enfrentes a algún error. No te preocupes, es algo normal. La combinación de PrestaShop y cPanel es potente, pero a veces pueden surgir conflictos de configuración, permisos o versiones.

Este artículo está diseñado para ser tu guía de referencia rápida. Vamos a desglosar los errores más comunes, explicando por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Al final, encontrarás una sección de FAQ errores para consultas rápidas.

1. El temido «Error 500» o «Página Blanca» en PrestaShop

Este es, sin duda, el error más frustrante. Ves una pantalla en blanco o un mensaje genérico de error interno del servidor. La causa suele ser un archivo corrupto, un plugin incompatible o un problema de memoria.

Causas principales

Módulo defectuoso: Has instalado un módulo nuevo y algo salió mal.
Límite de memoria PHP: PrestaShop necesita un mínimo de 128MB, aunque 256MB es lo recomendado.
Archivos .htaccess dañados: Una regla incorrecta puede bloquear la tienda.

Solución paso a paso

Accede a cPanel: Busca la sección «Administrador de archivos».
Localiza la raíz de PrestaShop: Normalmente es public_html o una subcarpeta.
Renombra el archivo .htaccess: Encuentra el archivo .htaccess (puede estar oculto, activa «Mostrar archivos ocultos»). Renómbralo a .htaccess_old.
Prueba la tienda: Si ahora ves la página, el problema era el .htaccess. Puedes regenerarlo desde el panel de administración de PrestaShop (Parámetros de la tienda > Tráfico y SEO > SEO y URLs > Guardar).
Aumenta la memoria PHP:
- Ve a la sección «Seleccionar versión de PHP» en cPanel (dentro de Software).
- Haz clic en «Opciones» o «Switch to PHP Options».
- Busca memory_limit y cámbialo a 256M o 512M.
- Guarda los cambios.
Desactiva módulos sospechosos:
- Si no puedes acceder al panel de administración, usa el Administrador de archivos.
- Ve a la carpeta modules y renombra la carpeta del módulo problemático (ej: nombre_modulo_old).

[WARNING] Si renombras un módulo esencial (como el de pago o envío), la tienda puede fallar. Hazlo con cuidado y solo con módulos que hayas instalado recientemente.

2. «Error de conexión a la base de datos» en PrestaShop

Este error aparece cuando PrestaShop no puede comunicarse con MySQL. Verás un mensaje similar a «Cannot connect to the database».

Causas principales

Credenciales incorrectas: Has cambiado la contraseña de la base de datos en cPanel.
Servidor MySQL caído: Temporalmente, el servicio de bases de datos no responde.
Prefijo de tabla equivocado: Al restaurar una copia de seguridad, el prefijo no coincide.

Solución paso a paso

Verifica el estado de MySQL en cPanel: Busca la sección «MySQL Databases» y comprueba que la base de datos aparece en la lista.
Revisa el archivo de configuración:
- En el Administrador de archivos, ve a la carpeta app/config (o config en versiones antiguas).
- Busca el archivo parameters.php.
- Ábrelo y verifica que los datos (database_host, database_name, database_user, database_password) coinciden exactamente con los de tu base de datos en cPanel.
Comprueba el usuario de la base de datos:
- En cPanel, entra en «MySQL Databases».
- Asegúrate de que el usuario de la base de datos está añadido a la base de datos correcta y tiene todos los privilegios (marca «ALL PRIVILEGES»).
Resetea la contraseña:
- Si sospechas que la contraseña es incorrecta, cámbiala desde cPanel y actualiza el archivo parameters.php.

[TIP] Siempre usa contraseñas seguras que combinen letras, números y símbolos. Evita usar caracteres especiales como & o % que puedan romper la sintaxis del archivo.

3. Problemas con el envío de correos (Contacto, Pedidos, Recuperación de contraseña)

PrestaShop depende del envío de correos para notificaciones. Si los correos no llegan, puede deberse a la configuración SMTP.

Causas principales

Servidor SMTP no configurado: Estás usando la función mail() de PHP, que muchos hostings bloquean.
Puerto incorrecto: El puerto SMTP (587 o 465) no es el que tu hosting permite.
Autenticación fallida: El usuario o contraseña del correo SMTP es erróneo.

Solución paso a paso

Accede al panel de administración de PrestaShop.
Ve a Parámetros de la tienda > Contacto > Opciones de correo electrónico.
Cambia el «Método de envío» de «Usar la función mail() de PHP» a «Configurar mis propios parámetros SMTP».
Introduce los datos de tu cuenta de correo profesional (la que creaste en cPanel, ej: tu-tienda@tudominio.com).
Configuración típica SMTP:
- Servidor: mail.tudominio.com o smtp.tudominio.com (pregunta a tu hosting).
- Usuario: tu-tienda@tudominio.com
- Contraseña: La de la cuenta de correo.
- Puerto: 587 (con TLS) o 465 (con SSL).
- Cifrado: TLS o SSL.
Haz clic en «Guardar» y luego en «Enviar un correo de prueba».

[INFO] Si tu hosting usa Syspanel (antes HestiaCP), recuerda que el puerto de acceso al panel es el 2106. La configuración SMTP suele ser más sencilla, pero los pasos son los mismos.

4. Errores al subir archivos o imágenes (Permisos)

A veces, al intentar subir una imagen de producto o un logo, aparece un error de «No se puede escribir en el directorio». Esto es por permisos de archivos.

Causas principales

Permisos incorrectos: Las carpetas de PrestaShop deben tener permisos 755 y los archivos 644.
Propietario del archivo: El usuario de cPanel no es el propietario de los archivos (común al migrar).

Solución paso a paso

Desde cPanel, ve al Administrador de archivos.
Selecciona toda la carpeta de PrestaShop (marca la casilla de la carpeta raíz).
Haz clic en «Cambiar permisos» en la barra superior.
Aplica los permisos estándar:
- Carpetas: 755 (marca: Propietario: rwx, Grupo: r-x, Público: r-x).
- Archivos: 644 (marca: Propietario: rw-, Grupo: r--, Público: r--).
Verifica las carpetas específicas:
- Las carpetas img, upload, download, themes, modules y var/cache deben tener permisos 755 o incluso 777 si el problema persiste (aunque 777 no es seguro a largo plazo).

[WARNING] No pongas permisos 777 en toda la raíz. Solo en las carpetas que requieren escritura temporalmente. Después, revierte a 755.

5. El SEO de PrestaShop no funciona: URLs amigables rotas

Las URLs amigables (ej: /zapatos-deportivos en lugar de /index.php?id_product=1) son cruciales para el SEO. Si no funcionan, tu tienda tendrá problemas de indexación.

Causas principales

Módulo mod_rewrite desactivado: Apache necesita este módulo activo.
Archivo .htaccess no generado: PrestaShop no pudo escribir el archivo de reglas.
Cache de smarty lleno: Las reglas viejas causan conflictos.

Solución paso a paso

Verifica que mod_rewrite está activo:
- En cPanel, ve a «Seleccionar versión de PHP».
- Busca la opción «Extensiones» y asegúrate de que mod_rewrite (o rewrite_module) está marcado.
Regenera el .htaccess:
- Ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs.
- Desactiva la opción «URLs amigables», guarda, luego actívala de nuevo y guarda.
- Esto fuerza a PrestaShop a escribir un nuevo .htaccess.
Limpia la caché de PrestaShop:
- Ve a Parámetros avanzados > Rendimiento.
- Haz clic en «Forzar compilación» y luego en «Limpiar caché».
Comprueba el archivo .htaccess:
- Ábrelo con el Administrador de archivos. Debe comenzar con RewriteEngine On. Si está vacío, repite el paso 2.

6. Error «El archivo no se puede cargar» al instalar un módulo o tema

Este error suele deberse a limitaciones en la configuración de PHP, no a que el archivo esté dañado.

Causas principales

Límite de subida de archivos (upload_max_filesize) pequeño: Por defecto, suele ser 2MB o 8MB.
Límite de tamaño de POST (post_max_size) pequeño.

Solución paso a paso

Accede a «Seleccionar versión de PHP» en cPanel.
Haz clic en «Opciones».
Aumenta estos valores:
- upload_max_filesize: Ponlo a 64M o 128M.
- post_max_size: Ponlo a 64M o 128M.
- max_execution_time: Ponlo a 300 (segundos).
Guarda los cambios y espera unos minutos a que se apliquen.
Vuelve a intentar la subida del módulo o tema desde el panel de administración.

FAQ Errores: Preguntas frecuentes rápidas

Aquí tienes una lista de preguntas y respuestas para problemas muy concretos.

¿Por qué veo «Error 404» en páginas de producto o categoría?

Solución: Ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs. Activa la opción «Redireccionar a la URL canónica» y guarda. Luego, limpia la caché.

¿Cómo soluciono el error «El token de seguridad no es válido» al intentar acceder al back office?

Solución: Esto suele pasar por una IP dinámica. Accede a tu base de datos desde phpMyAdmin en cPanel. Busca la tabla ps_employee y localiza tu usuario. Borra el contenido del campo id_last_employee (déjalo vacío). Luego, desde el Administrador de archivos, borra la carpeta var/cache (o cache en versiones antiguas).

¿Por qué mi tienda está muy lenta? (Relacionado con cPanel)

Posibles causas: Falta de caché, módulos pesados, o un servidor compartido saturado. Activa la caché en Parámetros avanzados > Rendimiento (elige «Sistema de archivos» o «Redis» si tu hosting lo soporta). También puedes optimizar las imágenes de los productos.

¿Qué hago si no puedo acceder a cPanel?

Solución: Contacta a tu proveedor de hosting. Si usas Syspanel, recuerda que el puerto de acceso es 2106 (ej: tudominio.com:2106). Si no lo recuerdas, pide a tu hosting que te lo confirme.

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

Solución:
1. En cPanel, ve a «phpMyAdmin», selecciona tu base de datos y haz clic en «Importar». Sube el archivo SQL.
2. En el Administrador de archivos, sube la copia de los archivos de PrestaShop y sobrescribe los existentes.
3. Importante: Asegúrate de que el archivo parameters.php tenga las credenciales de la base de datos restaurada.

Consejo final para evitar errores

La mejor solución para los errores PrestaShop en cPanel es la prevención. Antes de hacer cualquier cambio importante (actualizar módulos, cambiar de tema, migrar), haz siempre una copia de seguridad completa de los archivos y la base de datos.

Si has seguido todos los pasos y el problema persiste, no dudes en contactar con el soporte técnico de tu hosting. Ellos pueden verificar la configuración del servidor que no está a tu alcance, como el firewall o el límite de procesos.

Esperamos que esta guía te haya sido de gran ayuda. ¡Tu tienda PrestaShop volverá a funcionar como un reloj!