Errores frecuentes de PrestaShop en cPanel | FAQ y soluciones

¿Tu tienda PrestaShop se ha vuelto loca de repente? ¿Ves pantallas en blanco, errores de conexión a la base de datos o problemas al instalar módulos? Tranquilo, es más común de lo que crees. En este artículo vamos a desglosar los errores PrestaShop cPanel más frecuentes y, lo mejor de todo, te daremos pasos claros y sencillos para solucionar PrestaShop sin necesidad de ser un experto en desarrollo. Si estás gestionando tu tienda desde cPanel PrestaShop problemas como estos, aquí encontrarás la solución.

Vamos a ir paso a paso, como si estuviéramos viendo juntos el panel de control. No te preocupes por los tecnicismos: todo está explicado de forma clara y directa.

Error 500: La temida pantalla en blanco

Este es, sin duda, uno de los errores PrestaShop cPanel más desesperantes. Abres tu tienda y solo ves un fondo blanco. Nada más. Ni un mensaje de error. ¿Qué ha pasado? Generalmente, este error se debe a un problema con los archivos del núcleo de PrestaShop, un módulo incompatible o un límite de memoria excedido.

Solución paso a paso

Activa el modo debug de PrestaShop. Para ello, accede a tu archivo /config/defines.inc.php desde el administrador de archivos de cPanel. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Esto mostrará el error real en lugar de la pantalla blanca.
Revisa el error concreto. Una vez activado el modo debug, verás un mensaje como "Fatal error: Allowed memory size of X bytes exhausted". Eso te indica que necesitas aumentar la memoria PHP.
Aumenta el límite de memoria PHP. En cPanel, busca la sección "Seleccionar versión de PHP" (o "MultiPHP Manager"). Dentro, haz clic en "Opciones" o "Switch to PHP Options". Busca la opción memory_limit y cámbiala a 256M o incluso 512M. Guarda los cambios.
Desactiva módulos sospechosos. Si el problema persiste, puede ser un módulo recién instalado. Desde el administrador de archivos, renombra la carpeta /modules/nombre_del_modulo a /modules/nombre_del_modulo_backup. Haz esto con los módulos que hayas instalado recientemente.
Vuelve a cargar la tienda. Si el error desaparece, ya sabes qué módulo causaba el problema. Puedes reinstalarlo o contactar al desarrollador.

[INFO] Si después de estos pasos el error 500 sigue apareciendo, puede que el problema esté en los permisos de archivos. Asegúrate de que las carpetas tengan permisos 755 y los archivos 644. Puedes cambiarlos desde el administrador de archivos de cPanel.

Error de conexión a la base de datos: "Link to database cannot be established"

Este es otro clásico. Tu tienda no puede conectar con la base de datos donde se almacenan los productos, clientes y pedidos. Las causas suelen ser un cambio de contraseña, un error en el archivo de configuración o que la base de datos simplemente se haya caído.

Solución paso a paso

Verifica los datos de conexión. Accede a tu cPanel y busca la sección "Bases de datos MySQL". Allí verás el nombre de tu base de datos y el usuario. Asegúrate de recordar la contraseña.
Revisa el archivo de configuración. Conéctate a tu servidor vía FTP o usa el administrador de archivos de cPanel. Busca el archivo /app/config/parameters.php. Ábrelo y verifica que los valores database_host, database_name, database_user y database_password sean correctos.
Prueba la conexión manualmente. Desde cPanel, abre "phpMyAdmin". Intenta iniciar sesión con el usuario y contraseña que tienes en el archivo parameters.php. Si no puedes, la contraseña está mal. Restablécela desde "Bases de datos MySQL".
Reinicia el servicio de base de datos. Si todo parece correcto pero el error persiste, contacta a tu proveedor de hosting y pídele que reinicie el servicio MySQL/MariaDB. A veces el servicio se queda colgado.

[WARNING] Nunca edites el archivo parameters.php directamente con un editor de texto como el Bloc de notas. Usa siempre un editor de código (como Notepad++ o VS Code) para evitar problemas de codificación.

Problemas con los enlaces amigables (URL rewriting)

¿Has activado los enlaces amigables en PrestaShop y ahora todas las páginas dan error 404? Esto es muy común y suele deberse a que el archivo .htaccess no se ha generado correctamente o el módulo mod_rewrite de Apache no está activo.

Solución paso a paso

Regenera el archivo .htaccess. Desde el panel de administración de PrestaShop, ve a "Configuración de la tienda" > "Tráfico y SEO" > "SEO y URL". Desplázate hasta el final y haz clic en "Guardar" sin cambiar nada. Esto forzará a PrestaShop a regenerar el archivo .htaccess.
Verifica que mod_rewrite esté activo. En cPanel, busca la sección "Seleccionar versión de PHP" o "MultiPHP Manager". Aunque esto no gestiona módulos de Apache directamente, puedes verificar si hay algún problema de compatibilidad. Si no estás seguro, contacta al soporte de tu hosting y pregúntales si mod_rewrite está habilitado.
Comprueba los permisos del archivo .htaccess. El archivo .htaccess debe tener permisos 644 o 664. Puedes verificarlo desde el administrador de archivos de cPanel. Si no existe, puedes crear uno vacío y luego regenerarlo desde PrestaShop.
Revisa la configuración de Apache. Si tu hosting usa Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106. Allí podrás ver la configuración de Apache y asegurarte de que no haya reglas que bloqueen el rewrite.

[TIP] Si después de regenerar el .htaccess sigues teniendo errores 404, prueba a desactivar los enlaces amigables temporalmente desde el panel de administración. Luego, vuelve a activarlos y regenera el archivo. A veces el orden de las reglas se corrompe.

Error al instalar un módulo o tema: "No se puede escribir en la carpeta"

¿Has intentado instalar un nuevo módulo y te aparece un mensaje de error diciendo que no se puede escribir en cierta carpeta? Esto es un problema de permisos, muy común en cPanel PrestaShop problemas de instalación.

Solución paso a paso

Identifica la carpeta problemática. El mensaje de error te indicará la ruta exacta (por ejemplo, /modules o /themes). Anótala.
Cambia los permisos de la carpeta. Desde el administrador de archivos de cPanel, navega hasta la carpeta en cuestión. Haz clic derecho sobre ella y selecciona "Cambiar permisos". Asegúrate de que esté en 755 (lectura y ejecución para todos, escritura solo para el propietario).
Verifica el propietario de los archivos. A veces, aunque los permisos sean correctos, el propietario de los archivos no coincide con el usuario del servidor web. Si tu hosting usa Syspanel, el propietario suele ser admin o el nombre de tu cuenta. Si tienes dudas, contacta al soporte.
Prueba la instalación de nuevo. Una vez corregidos los permisos, vuelve a intentar la instalación del módulo o tema. Si el error persiste, puede que el archivo que estás subiendo esté dañado. Descárgalo de nuevo desde la fuente oficial.

[INFO] Nunca pongas permisos 777 en ninguna carpeta de PrestaShop. Aunque parezca una solución rápida, deja tu tienda vulnerable a ataques. Usa siempre 755 para carpetas y 644 para archivos.

Problemas con la memoria y el tiempo de ejecución

¿Tu tienda se vuelve muy lenta o ves errores como "Maximum execution time of 30 seconds exceeded"? Esto indica que los scripts de PrestaShop están tardando más de lo permitido o consumiendo más memoria de la disponible.

Solución paso a paso

Aumenta el tiempo de ejecución. En cPanel, ve a "Seleccionar versión de PHP" > "Opciones". Busca la opción max_execution_time y cámbiala a 120 (segundos). Guarda los cambios.
Aumenta la memoria por script. En la misma sección, busca memory_limit y cámbialo a 256M o 512M. Esto es especialmente útil si tienes muchos productos o módulos pesados.
Optimiza las imágenes. Las imágenes de productos son una de las principales causas de lentitud. Usa herramientas como TinyPNG o el módulo de optimización de imágenes de PrestaShop para reducir su peso sin perder calidad.
Revisa los módulos activos. Desactiva temporalmente los módulos que no uses o que sean muy pesados. A veces un módulo mal programado consume todos los recursos.

[WARNING] Si tu hosting es muy básico (plan compartido), es posible que no puedas aumentar estos valores más allá de cierto límite. En ese caso, considera migrar a un plan superior o a un hosting especializado en PrestaShop.

El carrito de compras no funciona o da error

¿Los clientes te dicen que no pueden añadir productos al carrito o que el proceso de pago se queda colgado? Este es un problema común que puede tener varias causas, desde problemas con las cookies hasta conflictos con módulos de pago.

Solución paso a paso

Limpia la caché de PrestaShop. Desde el panel de administración, ve a "Configuración avanzada" > "Rendimiento". Haz clic en "Limpiar caché" (tanto la de Smarty como la de la memoria caché).
Verifica las cookies. A veces el problema está en las cookies del navegador del cliente. Pídele que borre las cookies de tu dominio y que vuelva a intentarlo.
Desactiva el SSL temporalmente. Si tienes un certificado SSL mal configurado, puede interferir con el carrito. Ve a "Configuración de la tienda" > "General" y desmarca "Activar SSL". Luego, vuelve a marcarlo y guarda. Esto regenera las rutas.
Revisa los módulos de pago. Desactiva todos los módulos de pago excepto uno (por ejemplo, "Transferencia bancaria"). Si el carrito funciona, activa los demás uno por uno hasta encontrar el conflictivo.

[TIP] Si el problema solo ocurre con un navegador específico (por ejemplo, Chrome), pide al cliente que pruebe con otro (Firefox, Edge). A veces es un problema de compatibilidad del navegador y no de tu tienda.

Error al enviar correos electrónicos

¿Los pedidos se crean pero no llegan los correos de confirmación ni a ti ni a tus clientes? Esto suele deberse a una mala configuración del envío de correos en PrestaShop o a que tu servidor de hosting bloquea los envíos.

Solución paso a paso

Verifica la configuración de correo. En el panel de administración, ve a "Configuración de la tienda" > "Contacto" > "Configuración de correo electrónico". Asegúrate de que el método de envío sea "Usar la función mail de PHP" si tu hosting lo permite. Si no, elige "Establecer mis propios parámetros SMTP" y configura los datos de tu servidor de correo (puedes usar Gmail, Outlook, etc.).
Prueba el envío manual. En la misma pantalla, haz clic en "Enviar un correo de prueba". Si no llega, el problema está en el servidor.
Revisa el SPF y DKIM. Si usas un servidor SMTP externo (como Gmail), asegúrate de que los registros SPF y DKIM de tu dominio estén correctamente configurados. Esto lo puedes hacer desde cPanel en la sección "Zone Editor" o "Editor de Zona DNS".
Contacta a tu hosting. Si todo lo anterior falla, puede que tu proveedor de hosting tenga restricciones para el envío de correos desde scripts de PHP. Pregúntales si tienen algún servicio de correo transaccional (como SendGrid o Mailgun) que puedas usar.

[INFO] Algunos hostings bloquean el envío de correos desde el propio servidor para evitar spam. En ese caso, la solución más fiable es usar un servicio SMTP externo. Te recomiendo configurar Gmail o SendGrid para PrestaShop.

Conclusión: No te rindas, todo tiene solución

Como has visto, los errores PrestaShop cPanel son variados pero casi siempre tienen una solución clara. La clave está en ir paso a paso, sin saltarte ninguna verificación, y sobre todo, en mantener tu PrestaShop actualizado y con los permisos correctos.

Recuerda que, si tu hosting usa Syspanel, el puerto de acceso es el 2106 y allí también podrás gestionar muchas de estas configuraciones. No dudes en consultar la documentación de tu proveedor o abrir un ticket de soporte si algo se te escapa.

Solucionar PrestaShop no tiene por qué ser una pesadilla. Con esta guía, esperamos haberte ayudado a resolver los cPanel PrestaShop problemas más comunes. Si te ha sido útil, compártela con otros dueños de tiendas que estén pasando por lo mismo. ¡Buena suerte con tu tienda!