Solución de errores comunes en PrestaShop con Syspanel
Si estás leyendo esto, es probable que tu tienda PrestaShop no esté funcionando como esperas. Tal vez ves una pantalla en blanco, no puedes acceder al panel de administración, los productos no se cargan o el carrito de compras falla. No te preocupes. En esta guía, te explicaré paso a paso cómo solucionar los errores más comunes en PrestaShop utilizando Syspanel, el panel de control de tu servidor. Recuerda que para acceder a Syspanel, debes ir a tu-dominio.com:2106 (el puerto 2106 es exclusivo de Syspanel).
Aquí resolveremos desde problemas de permisos hasta errores de base de datos, todo con un lenguaje claro y sencillo. Vamos a ello.
¿Por qué ocurren los errores en PrestaShop?
PrestaShop es un gestor de tiendas online potente, pero también delicado. Los fallos suelen deberse a:
- Actualizaciones incompletas de módulos o del propio PrestaShop.
- Problemas de permisos en archivos y carpetas.
- Errores de memoria (PHP memory limit).
- Conflictos entre temas o módulos.
- Problemas con la base de datos (MySQL).
Syspanel te permite gestionar estos aspectos sin necesidad de ser un experto en servidores. Vamos a ver los casos más frecuentes.
Error 1: Pantalla en blanco o "Error 500 Internal Server Error"
Este es uno de los errores PrestaShop más temidos. La tienda no carga nada, solo ves una página blanca o un mensaje de error del servidor.
Solución paso a paso con Syspanel
- Accede a Syspanel: Abre tu navegador y escribe
tu-dominio.com:2106. Inicia sesión con tu usuario y contraseña de hosting. - Activa el modo debug de PrestaShop: Esto te mostrará el error real en lugar de la pantalla blanca.
- Ve a Archivos > Administrador de archivos.
- Navega a la carpeta raíz de tu tienda (normalmente
public_htmlotu-dominio). - Busca el archivo
config/defines.inc.php. - Edítalo y cambia la línea:
por:define('_PS_MODE_DEV_', false);define('_PS_MODE_DEV_', true); - Guarda los cambios.
- Vuelve a cargar tu tienda: Ahora verás un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size exhausted").
- Aumenta el límite de memoria PHP (si el error es de memoria):
- En Syspanel, ve a Configuración del servidor > PHP.
- Busca la opción
memory_limity cámbiala a256Mo512M. - Guarda y reinicia PHP si es necesario.
- Desactiva el modo debug una vez solucionado: Vuelve a poner
define('_PS_MODE_DEV_', false);endefines.inc.php.
[TIP] Si el error persiste, revisa los logs de error en Syspanel: Registros > Registros de errores. Allí verás la causa exacta.
Error 2: "No se puede conectar a la base de datos" o "Error de conexión MySQL"
Este error suele aparecer después de mover la tienda a otro servidor o al cambiar la contraseña de la base de datos.
Solución paso a paso con Syspanel
- Verifica los datos de conexión en PrestaShop:
- En Syspanel, ve a Archivos > Administrador de archivos.
- Abre la carpeta
app/config/y edita el archivoparameters.php. - Busca las líneas:
'database_host' => 'localhost', 'database_name' => 'nombre_base', 'database_user' => 'usuario_base', 'database_password' => 'contraseña', - Asegúrate de que coincidan con los datos de tu base de datos en Syspanel.
- Comprueba la base de datos desde Syspanel:
- Ve a Base de datos > phpMyAdmin.
- Inicia sesión con los mismos datos. Si no puedes acceder, la base de datos está corrupta o los datos son incorrectos.
- Repara la base de datos (si está corrupta):
- En phpMyAdmin, selecciona tu base de datos.
- Marca todas las tablas (clic en "Seleccionar todo").
- En el menú desplegable, elige Reparar tabla.
- Cambia la contraseña de la base de datos (si olvidaste la contraseña):
- En Syspanel, ve a Base de datos > Usuarios de base de datos.
- Junto al usuario, haz clic en Editar y escribe una nueva contraseña.
- Actualiza también el archivo
parameters.phpcon la nueva contraseña.
[WARNING] Nunca uses caracteres especiales como
&o#en contraseñas de base de datos, ya que pueden romper la conexión.
Error 3: Imágenes que no se cargan o aparecen rotas
Las imágenes de productos, categorías o el logotipo no se muestran. Esto es muy común después de migraciones o al cambiar de dominio.
Solución paso a paso con Syspanel
- Regenera las miniaturas de imágenes desde el panel de administración de PrestaShop:
- Ve a Mejorar > Imágenes.
- Haz clic en Regenerar miniaturas.
- Selecciona todas las imágenes y confirma.
- Si la regeneración falla, es probable que falten permisos en la carpeta de imágenes:
- En Syspanel, ve a Archivos > Administrador de archivos.
- Navega a
img/(dentro de la raíz de tu tienda). - Haz clic derecho en la carpeta
imgy selecciona Permisos. - Establece 755 para carpetas y 644 para archivos.
- Marca la opción "Aplicar a subcarpetas y archivos".
- Verifica la ruta de las imágenes en la base de datos (si el problema persiste):
- En Syspanel, ve a Base de datos > phpMyAdmin.
- Ejecuta esta consulta SQL (reemplaza
ps_por tu prefijo de tabla):SELECT * FROM ps_image WHERE id_image = 1; - Comprueba que la ruta en
id_productypositionsea correcta.
[INFO] Si cambiaste de dominio, recuerda actualizar la URL en Parámetros de la tienda > Tráfico y SEO > Configuración de la tienda.
Error 4: El carrito de compras no funciona o da error
Los clientes no pueden añadir productos al carrito, o el carrito se vacía solo. Esto puede deberse a problemas con sesiones o módulos.
Solución paso a paso con Syspanel
- Limpia la caché de PrestaShop:
- Desde el panel de administración: Mejorar > Rendimiento > Limpiar caché.
- También puedes hacerlo manualmente desde Syspanel:
- Ve a Archivos > Administrador de archivos.
- Elimina todo el contenido de la carpeta
var/cache/(no la carpeta en sí).
- Verifica las sesiones PHP:
- En Syspanel, ve a Configuración del servidor > PHP.
- Busca
session.save_pathy asegúrate de que apunte a una carpeta existente (por ejemplo,/tmp). - Si está vacío, cámbialo a
/tmpy guarda.
- Desactiva módulos conflictivos:
- Desde el panel de administración: Módulos > Gestor de módulos.
- Desactiva módulos de carrito, pago o envío uno por uno para identificar el culpable.
- Si no puedes acceder al panel, renombra la carpeta del módulo desde Syspanel:
- Ve a Archivos > Administrador de archivos >
modules/. - Busca la carpeta del módulo (ej.
ps_shoppingcart) y renómbrala aps_shoppingcart_old.
- Ve a Archivos > Administrador de archivos >
[TIP] Los módulos de terceros (no oficiales) suelen ser la causa más común. Mantén solo los que realmente necesites.
Error 5: El panel de administración no carga o da error 404
Accedes a tu-dominio.com/admin1234 y ves un error 404 o una página en blanco.
Solución paso a paso con Syspanel
- Verifica que la carpeta admin existe:
- En Syspanel, ve a Archivos > Administrador de archivos.
- Busca una carpeta con nombre tipo
admin1234(o el que hayas usado). Si no está, la has borrado accidentalmente.
- Restaura la carpeta admin (si la borraste):
- Descarga una copia limpia de PrestaShop desde la web oficial.
- Sube la carpeta
admin(renómbrala a tu nombre original) a través del Administrador de archivos de Syspanel. - Luego, en la base de datos (phpMyAdmin), ejecuta:
Esto te dará acceso de superadmin.UPDATE ps_employee SET id_profile = 1 WHERE email = 'tu-email@ejemplo.com';
- Corrige el archivo .htaccess (si hay error 404):
- En Syspanel, ve a Archivos > Administrador de archivos.
- Busca el archivo
.htaccessen la raíz. Si no existe, crea uno nuevo con este contenido:
(ReemplazaRewriteEngine On RewriteRule ^admin1234/(.*) admin1234/$1 [L]admin1234por tu carpeta real).
[WARNING] Si cambiaste la URL del administrador, asegúrate de que el archivo
config/defines.inc.phptenga la líneadefine('_PS_ADMIN_DIR_', '/ruta/a/tu/admin');correcta.
Error 6: La tienda está muy lenta o se cae constantemente
Los clientes se quejan de que la tienda tarda en cargar o da timeout.
Solución paso a paso con Syspanel
- Aumenta los recursos PHP:
- En Syspanel, ve a Configuración del servidor > PHP.
- Aumenta
max_execution_timea 300,memory_limita 256M ymax_input_timea 300.
- Activa la caché de PrestaShop:
- En el panel de administración: Mejorar > Rendimiento.
- Activa Caché (recomendado: Sistema de archivos o Memcached si está disponible).
- Activa Combinar, comprimir y almacenar en caché para CSS y JavaScript.
- Optimiza la base de datos:
- En Syspanel, ve a Base de datos > phpMyAdmin.
- Selecciona tu base de datos y haz clic en Optimizar (en la pestaña "Operaciones").
- Revisa el uso de recursos:
- En Syspanel, ve a Estadísticas > Uso de recursos.
- Si el CPU o la memoria están al 100%, considera actualizar tu plan de hosting.
[INFO] Los módulos de terceros mal optimizados son la principal causa de lentitud. Revisa los logs de error en Syspanel para identificar cuál.
Preguntas frecuentes (FAQ)
¿Cómo accedo a Syspanel?
Escribe tu-dominio.com:2106 en tu navegador. Usa las credenciales que te proporcionó tu proveedor de hosting.
¿Qué hago si no recuerdo la contraseña de Syspanel?
Solicita un restablecimiento de contraseña desde la pantalla de inicio de sesión de Syspanel (enlace "¿Olvidaste tu contraseña?"). Si no funciona, contacta a tu soporte de hosting.
¿Puedo usar Syspanel para hacer copias de seguridad de mi PrestaShop?
Sí. Ve a Copia de seguridad en Syspanel. Puedes programar copias automáticas diarias o semanales. Recuerda incluir tanto los archivos como la base de datos.
¿Cómo restauro una copia de seguridad desde Syspanel?
En Copia de seguridad, selecciona la copia que deseas restaurar y haz clic en Restaurar. Asegúrate de que tu tienda esté en modo mantenimiento durante el proceso.
¿Qué hago si mi tienda se infectó con malware?
Desde Syspanel, ve a Seguridad > Escáner de malware. Ejecuta un análisis completo. Si encuentra archivos infectados, elimínalos o ponlos en cuarentena. Luego cambia todas las contraseñas (Syspanel, base de datos, PrestaShop).
¿Por qué mi PrestaShop no se actualiza correctamente?
Las actualizaciones fallan por límites de tiempo de ejecución o memoria. Antes de actualizar, desde Syspanel aumenta max_execution_time a 600 y memory_limit a 512M. También desactiva todos los módulos de terceros temporalmente.
Consejos finales para evitar errores PrestaShop
- Mantén todo actualizado: PrestaShop, módulos, temas y PHP (usa PHP 8.1 o superior).
- Haz copias de seguridad semanales desde Syspanel.
- No instales módulos de fuentes no confiables.
- Revisa los logs de error en Syspanel al menos una vez al mes.
- Usa un tema oficial o de un desarrollador reputado.
Recuerda que Syspanel es tu aliado para solucionar problemas rápidamente. Con estos pasos, podrás resolver la mayoría de los PrestaShop fallos sin necesidad de ser un experto técnico. Si el error persiste, no dudes en contactar a tu soporte de hosting, pero asegúrate de proporcionarles el mensaje de error exacto que viste en el modo debug.
¡Espero que tu tienda vuelva a funcionar a la perfección!
