Errores Comunes de PrestaShop en Linux | Soluciones Prácticas

¿Por qué PrestaShop da errores en Linux y cómo empezar a solucionarlos?

Si estás leyendo esto, probablemente ya has visto algún mensaje de error en tu tienda PrestaShop y no sabes por dónde empezar. Tranquilo, es más común de lo que crees. Los errores prestashop en un entorno prestashop linux suelen tener causas muy concretas: permisos incorrectos, caché mal configurada, versiones de PHP incompatibles o problemas con la base de datos. La buena noticia es que la mayoría se resuelven con comandos sencillos y un poco de paciencia.

Antes de lanzarnos a ejecutar comandos como locos, es fundamental que entiendas una cosa: cada error tiene su origen. No es lo mismo un error de memoria que un problema de escritura en carpetas. Por eso, este artículo está pensado como una guía práctica de troubleshooting prestashop. Vamos a ir paso a paso, desde lo más básico hasta lo más técnico, pero siempre con explicaciones claras y ejemplos que puedas copiar y pegar.

1. Los 5 errores más frecuentes de PrestaShop en servidores Linux

Cuando trabajas con prestashop linux, hay una serie de fallos que se repiten constantemente. Conocerlos te ahorrará horas de búsqueda en foros. Aquí tienes un resumen de los más habituales:

Error 500 (Internal Server Error): El clásico. Suele aparecer tras una actualización, un cambio de tema o al instalar un módulo incompatible.
Error de conexión a la base de datos: "Link to database cannot be established". Casi siempre es por credenciales mal configuradas o porque el servicio MySQL/MariaDB se ha caído.
Página en blanco (White Screen of Death): La tienda carga, pero no muestra nada. Es un problema de memoria PHP o de un módulo que lanza una excepción fatal.
Error de permisos de archivos: No puedes subir imágenes, no se genera la caché o no se escriben los logs. Permisos incorrectos en las carpetas var, cache o img.
Errores de compatibilidad PHP: Tras actualizar PrestaShop, tu versión de PHP ya no es compatible y aparecen errores de tipo Fatal error: Uncaught Error.

2. Preparación inicial: Acceso por SSH y herramientas básicas

Para solucionar prestashop en Linux, necesitas acceso al servidor. Si tu hosting es un VPS o un servidor dedicado, tendrás acceso SSH. Si usas un panel de control como Syspanel (accede por el puerto 2106), también podrás abrir una terminal desde el propio panel.

[INFO] Si no sabes qué es SSH, piensa en ello como una ventana a tu servidor. Escribes comandos y el servidor los ejecuta. No muerde, solo hay que ir con cuidado.

Una vez dentro, estos son los comandos que más vas a usar:

# Ver la versión de PHP instalada
php -v

# Comprobar si MySQL/MariaDB está activo
systemctl status mysql

# Ver el espacio en disco
df -h

# Listar archivos con sus permisos
ls -la /ruta/de/tu/prestashop

3. Cómo corregir el error 500 en PrestaShop (Linux)

El error 500 es el más odiado, pero también el más fácil de diagnosticar si sabes dónde mirar. La clave está en los logs del servidor.

3.1. Habilitar y ver los logs de errores

Lo primero es ver qué está fallando exactamente. Ejecuta esto:

tail -f /var/log/apache2/error.log

O si usas Nginx:

tail -f /var/log/nginx/error.log

[WARNING] Si no ves nada en los logs, puede que el error lo esté ocultando PrestaShop. Activa el modo debug temporalmente editando el archivo config/defines.inc.php. Busca la línea _PS_MODE_DEV_ y cámbiala a true. Después, recarga la página y verás el error exacto. No olvides volver a ponerla en false cuando termines.

3.2. Solución rápida: Aumentar la memoria PHP

El error 500 suele venir por falta de memoria. Edita tu archivo php.ini:

sudo nano /etc/php/8.1/apache2/php.ini

Y busca la línea memory_limit. Cámbiala a:

memory_limit = 512M

Reinicia Apache:

sudo systemctl restart apache2

3.3. Forzar la regeneración de la caché de Smarty

Otra causa común es una caché corrupta. Elimina los archivos de caché manualmente:

cd /ruta/de/tu/prestashop
rm -rf var/cache/*
rm -rf var/logs/*

Después, desde el panel de administración, ve a Parámetros avanzados > Rendimiento y haz clic en "Vaciar la caché". Si no puedes entrar al panel, repite el comando anterior y reinicia el servidor web.

4. Solucionar el error de conexión a la base de datos

Este error da pánico porque parece que has perdido toda tu tienda. Pero no es así. Simplemente PrestaShop no puede conectarse a MySQL.

4.1. Comprobar que el servicio MySQL está corriendo

sudo systemctl status mysql

Si está inactivo, arráncalo:

sudo systemctl start mysql

4.2. Verificar las credenciales en el archivo de configuración

Los datos de conexión están en app/config/parameters.php. Revísalo:

'server' => 'localhost',
'database_name' => 'tu_base_de_datos',
'user' => 'tu_usuario',
'password' => 'tu_contraseña',

[TIP] Si cambiaste la contraseña de MySQL recientemente, este archivo seguirá teniendo la antigua. Actualízalo y guarda. Después, borra la caché de nuevo.

4.3. Probar la conexión manualmente desde la terminal

mysql -u tu_usuario -p -h localhost tu_base_de_datos

Si te da error de acceso, el problema es de credenciales. Si no te deja conectarte ni como root, hay que resetear la contraseña de MySQL. Ese es otro tema, pero te adelanto que con sudo mysql entras como root sin contraseña en la mayoría de sistemas.

5. Cómo arreglar la página en blanco (White Screen)

La pantalla en blanco es frustrante porque no te da ninguna pista. Pero es un problema muy típico de errores prestashop relacionados con PHP.

5.1. Aumentar el límite de memoria de ejecución

Además del memory_limit, revisa también max_execution_time:

max_execution_time = 300

5.2. Desactivar módulos problemáticos desde la base de datos

A veces un módulo recién instalado rompe todo. Si no puedes entrar al panel, desactívalo desde MySQL:

UPDATE ps_module SET active = 0 WHERE name = 'nombre_del_modulo';

Necesitas saber el nombre técnico del módulo. Si no lo recuerdas, lista todos:

SELECT name, active FROM ps_module;

5.3. Comprobar la versión de PHP

PrestaShop 8.x necesita PHP 7.2 o superior (idealmente 8.0 o 8.1). Si tu servidor tiene una versión antigua, actualízala:

sudo apt update
sudo apt install php8.1 php8.1-cli php8.1-common php8.1-mysql php8.1-xml php8.1-curl php8.1-mbstring

6. Errores de permisos: La pesadilla de los archivos

Linux es estricto con los permisos. Si PrestaShop no puede escribir archivos, verás errores al subir imágenes o al instalar módulos.

6.1. La regla de oro de los permisos

Para un hosting estándar, los permisos correctos son:

Carpetas: 755
Archivos: 644

Puedes aplicarlos con:

find /ruta/de/tu/prestashop -type d -exec chmod 755 {} \;
find /ruta/de/tu/prestashop -type f -exec chmod 644 {} \;

6.2. Dar permisos especiales a las carpetas de escritura

Las carpetas var, cache, img, log y config necesitan permisos más flexibles (775 o incluso 777 en entornos de desarrollo):

chmod -R 775 var cache img log config

[INFO] En producción, intenta no usar 777. Puede ser un riesgo de seguridad. Pero si te funciona y es un entorno pequeño, no pasa nada mientras tengas contraseñas seguras.

6.3. El propietario de los archivos

Asegúrate de que el usuario de tu servidor web (normalmente www-data en Apache o nginx en Nginx) sea el propietario:

sudo chown -R www-data:www-data /ruta/de/tu/prestashop

7. Errores específicos al actualizar PrestaShop en Linux

Las actualizaciones son el momento más delicado. Si algo falla, aquí tienes las soluciones más comunes.

7.1. Error "Cannot write to the cache folder"

Es un problema de permisos. Repite el paso 6.2 y asegúrate de que la carpeta var/cache existe y es escribible.

7.2. Error de incompatibilidad de módulos

Después de actualizar, algunos módulos no funcionan. Entra al panel de administración y desactiva todos los módulos no oficiales. Si no puedes entrar, usa el truco de MySQL del punto 5.2.

7.3. La actualización se queda a medias

Si la actualización se interrumpió, es posible que tengas que restaurar una copia de seguridad. Por eso siempre te recomiendo hacer backup antes de actualizar. Puedes hacerlo con:

mysqldump -u usuario -p base_datos > backup.sql
tar -czf prestashop_backup.tar.gz /ruta/de/tu/prestashop

8. Cómo evitar futuros errores de PrestaShop en Linux

La prevención es mejor que la cura. Con estos hábitos reducirás drásticamente los errores prestashop:

Mantén actualizado PHP, MySQL y PrestaShop a sus últimas versiones estables.
Haz backups automáticos semanales (o diarios si vendes mucho).
No instales módulos piratas o de dudosa procedencia. Son la principal fuente de vulnerabilidades y errores.
Revisa los logs una vez al mes. Te avisarán de problemas antes de que sean críticos.
Usa un entorno de pruebas (staging) para probar cambios antes de ponerlos en producción.

9. Preguntas frecuentes (FAQ) sobre errores de PrestaShop en Linux

¿Por qué mi PrestaShop da error 500 solo en algunas páginas?

Eso suele indicar que un módulo o una plantilla está mal codificada. Activa el modo debug (punto 3.1) y verás exactamente qué archivo falla.

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

Ve a Parámetros avanzados > Información en el panel de administración. También puedes ejecutar php -v en la terminal.

¿Es normal que PrestaShop cree muchas carpetas de caché?

Sí, es su funcionamiento normal. Pero si crecen demasiado, puedes programar una tarea cron para limpiarlas:

0 3 * * * rm -rf /ruta/de/tu/prestashop/var/cache/*

¿Qué hago si nada de esto funciona?

Respira. A veces el problema es más profundo (corrupción de base de datos, servidor sin recursos). Te recomiendo contactar con tu proveedor de hosting o contratar a un especialista en troubleshooting prestashop. No pasa nada por pedir ayuda.

Conclusión: La paciencia es la clave para solucionar PrestaShop en Linux

Como has visto, los errores prestashop en un entorno prestashop linux tienen soluciones claras y ordenadas. No necesitas ser un gurú de la línea de comandos, solo seguir una metodología lógica: leer los logs, comprobar permisos, revisar la memoria y tener cuidado con las actualizaciones.

[TIP] Guarda este artículo en tus favoritos. La próxima vez que tu tienda dé un error, en lugar de entrar en pánico, ya sabrás por dónde empezar. Y recuerda: si usas Syspanel como panel de control, siempre puedes acceder a tu servidor desde el puerto 2106 para gestionar estos ajustes de forma más visual.

La próxima vez que veas un error, sonríe. Ya sabes cómo arreglarlo.