Problemas comunes PrestaShop en Syspanel: FAQ y soluciones

¡Hola! Soy tu técnico de soporte amigable. Si tienes una tienda online con PrestaShop y estás usando Syspanel (nuestro panel de control basado en HestiaCP, que accedes por el puerto 2106), seguramente te has topado con algún que otro dolor de cabeza. No te preocupes, es normal. En esta FAQ (Preguntas Frecuentes) vamos a resolver los problemas comunes de hosting que más nos consultan. Al final de esta guía, serás capaz de solucionar muchos de estos percances sin necesidad de escalar un ticket.

Vamos a ello, paso a paso.

1. Mi tienda PrestaShop carga muy lenta o da error 500

Este es, sin duda, uno de los problemas comunes más frustrantes. Una tienda lenta ahuyenta clientes. Generalmente, la causa está en la configuración del servidor o en un plugin conflictivo.

¿Qué hago si veo una pantalla en blanco o un error 500?

El error 500 es un comodín, significa "algo salió mal en el servidor". Lo primero es ver el log de errores real.

Paso 1: Activar el modo debug de PrestaShop (temporalmente)

Esto te mostrará el error real en lugar de la pantalla en blanco.

Accede a tu servidor por FTP o desde el administrador de archivos de Syspanel (puerto 2106).
Busca el archivo config/defines.inc.php en la raíz de tu PrestaShop.
Edítalo y cambia la línea:
define('_PS_MODE_DEV_', false);
por:
define('_PS_MODE_DEV_', true);
Guarda el archivo. Ahora, al recargar tu tienda, verás un mensaje de error específico (por ejemplo, "Fatal error: Allowed memory size exhausted...").

[INFO] Anota ese error. Luego, vuelve a poner false en esa línea para que los clientes no vean el código feo.

Paso 2: Aumentar el límite de memoria PHP desde Syspanel

Si el error dice algo de "memory size", la solución es sencilla.

Ingresa a Syspanel (puerto 2106).
Ve a Advanced Options > Configure PHP.
Busca el parámetro memory_limit. Por defecto suele venir en 128M. Cámbialo a 256M o incluso 512M si tienes muchos módulos.
Guarda los cambios y reinicia el servicio PHP desde el mismo panel.

¿Y si la lentitud es general sin errores?

Prueba estos ajustes de hosting:

Activar la caché de PrestaShop: Ve a Parámetros de la Tienda > Rendimiento. Activa la caché y elíge "Sistema de archivos" o "Memcache" si tu servidor lo soporta. También activa "Combinar, minimizar y comprimir" para CSS y JavaScript.
Comprobar la versión de PHP: En Syspanel, en la misma sección "Configure PHP", asegúrate de usar PHP 8.0 o 8.1. Las versiones antiguas son muy lentas y no seguras.
Revisar el uso de recursos: En Syspanel tienes un monitor de uso de CPU y RAM. Si ves que siempre está al 100%, quizás necesitas un plan superior.

2. No puedo acceder al backoffice de PrestaShop

Te pide contraseña, pero no entra, o directamente te redirige a una página de error. Esto suele pasar tras una migración o una actualización.

Problemas con la URL o el .htaccess

Paso 1: Forzar la URL correcta desde la base de datos

A veces la URL guardada en la base de datos no coincide con la real.

Entra a Syspanel (puerto 2106) y busca phpMyAdmin.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_configuration (o prestashop_configuration).
Localiza las filas PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Edítalas y asegúrate de que tengan tu dominio exacto, sin http:// ni https://, solo tudominio.com.

Paso 2: Regenerar el .htaccess

Desde el backoffice (si puedes entrar de alguna forma), ve a Parámetros de la Tienda > Tráfico y SEO.
Sin cambiar nada, haz clic en Guardar. Esto regenera el archivo.
Si no puedes entrar al backoffice, descarga el archivo .htaccess de la raíz de tu tienda por FTP, renómbralo a .htaccess_old y luego entra a tu tienda. PrestaShop creará uno nuevo automáticamente.

Error "El sitio web ha encontrado un error"

Si el error persiste, suele ser por un módulo o tema corrupto.

Paso 3: Deshabilitar módulos desde la base de datos

En phpMyAdmin (dentro de Syspanel), busca la tabla ps_module.
Ejecuta esta consulta SQL (copia y pega en la pestaña SQL):
```
UPDATE ps_module SET active = 0 WHERE id_module > 0;
```
Esto desactiva TODOS los módulos.
Intenta acceder al backoffice. Si funciona, el problema es un módulo. Ve activándolos uno a uno desde el backoffice para encontrar el culpable.

[WARNING] Esta consulta desactiva todos los módulos, incluidos los nativos. No te asustes, tu tienda se verá básica, pero no pierdes datos.

3. Problemas con el envío de correos (no llegan pedidos, recuperación de contraseña)

PrestaShop depende del correo para muchas funciones. Si no configuras bien el servidor SMTP, los emails se perderán.

Solución: Configurar SMTP en PrestaShop

El envío por defecto (función mail de PHP) suele fallar en servidores compartidos. Mejor usa SMTP.

En el backoffice de PrestaShop, ve a Parámetros Avanzados > Correo electrónico.
Cambia "Método de envío" a "Configurar SMTP".
Rellena con los datos de tu cuenta de correo profesional (creada desde Syspanel):
- Servidor SMTP: mail.tudominio.com (o el que te dé tu proveedor).
- Usuario: tu@correo.com (el email completo).
- Contraseña: La de tu correo.
- Puerto: 587 (con TLS) o 465 (con SSL). Prueba primero con 587.
- Autenticación: Sí.
Haz clic en "Enviar un correo de prueba". Si llega, problema resuelto.

[TIP] Si no te llega el correo de prueba, revisa la carpeta de Spam. Si sigue sin llegar, prueba con el puerto 465 y SSL.

4. Error de conexión a la base de datos

Este es un problema común después de mover la tienda de un hosting a otro, o si alguien tocó los archivos de configuración.

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

La solución es revisar el archivo app/config/parameters.php.

Accede a tu servidor por FTP o por el gestor de archivos de Syspanel.
Navega hasta la carpeta app/config/ (en las versiones modernas de PrestaShop 1.7+) o config/settings.inc.php (en PrestaShop 1.6).
Abre el archivo parameters.php.

Busca las líneas de la base de datos:

'database_host' => 'localhost',
'database_name' => 'tu_basededatos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Verifica que estos datos coincidan exactamente con los que ves en Syspanel (en la sección de Bases de Datos).
Si cambiaste algo, guarda el archivo. Si el nombre de la base de datos o el usuario son incorrectos, corrígelos.

[INFO] En Syspanel, el nombre de la base de datos suele ser usuario_nombrebd. Asegúrate de incluir el prefijo del usuario.

5. El certificado SSL no funciona o da error de seguridad

Si tu tienda muestra "No seguro" o el candado está roto, los clientes desconfiarán.

Pasos para forzar HTTPS en PrestaShop desde Syspanel

Asegúrate de que el SSL está activo en Syspanel:
- Ve a Web > Dominio.
- Haz clic en el dominio de tu tienda.
- En la sección SSL Support, debe decir "Let's Encrypt" o "Certificado activo". Si no, actívalo y espera 2 minutos.
Forzar HTTPS en PrestaShop:
- En el backoffice, ve a Parámetros de la Tienda > Tráfico y SEO.
- Activa "Redirigir a HTTPS".
- Guarda.
Limpiar la caché:
- En Parámetros Avanzados > Rendimiento, limpia la caché.
- También limpia la caché de tu navegador.

Error de "contenido mixto" (mixed content)

Esto pasa cuando la web carga en HTTPS, pero algunos recursos (imágenes, CSS) se cargan en HTTP. El candado se rompe.

Instala un módulo gratuito como "HTTP to HTTPS" o "Really Simple SSL" (si está disponible para tu versión).
O, si tienes acceso a phpMyAdmin, ejecuta esta consulta para actualizar todas las URLs de la base de datos:
```
UPDATE ps_product SET reference = REPLACE(reference, 'http://', 'https://');
```
(Adapta el nombre de la tabla según tu prefijo, por ejemplo, ps_product, ps_image, etc.)

[WARNING] Ten cuidado con las consultas SQL. Si no te sientes seguro, mejor pide ayuda a soporte.

6. No puedo instalar módulos o temas (error de permisos)

Al intentar subir un módulo, PrestaShop dice "No se puede escribir" o "Permiso denegado".

Solución: Dar permisos 755 a las carpetas desde Syspanel

En Syspanel, ve a Web > File Manager.
Navega a la raíz de tu PrestaShop.
Selecciona las carpetas modules, themes, img, upload y download.
Haz clic derecho > Change Permissions.
Pon 755 para directorios y 644 para archivos.
Marca la opción "Apply to subdirectories" (Aplicar a subdirectorios).
Confirma.

También puedes hacerlo por FTP con un cliente como FileZilla: selecciona las carpetas, clic derecho > "Permisos de archivo" > 755.

7. Preguntas rápidas (FAQ exprés)

¿Cada cuánto debo limpiar la caché de PrestaShop?

Cada vez que hagas cambios en productos, módulos o diseño. Si no haces cambios, una vez al mes es suficiente.

¿Puedo usar Syspanel para hacer copias de seguridad?

¡Sí! Es una de las mejores funciones. Ve a Backup en Syspanel (puerto 2106). Puedes programar backups automáticos diarios o semanales. Guarda siempre una copia en tu ordenador.

¿Qué hago si mi web se cae por mucho tráfico?

Syspanel te permite ver el uso de recursos en tiempo real. Si ves picos, puedes:

Activar la caché de PrestaShop (como vimos antes).
Usar un plugin de caché de páginas.
Contactar con soporte para una solución de hosting más potente.

¿Es seguro usar PrestaShop 1.6 en 2025?

No. Está obsoleto y tiene vulnerabilidades. Migra a PrestaShop 8.x lo antes posible. Syspanel soporta las últimas versiones de PHP (8.1, 8.2) que son necesarias para PrestaShop 8.

Resumen final: Checklist de diagnóstico

Si tu tienda falla, sigue este orden:

Revisa los logs de errores en Syspanel (sección Logs o Error Log).
Activa el modo debug de PrestaShop para ver el error exacto.
Verifica los permisos de las carpetas (755) y archivos (644).
Comprueba la versión de PHP en Syspanel (debe ser 8.0 o superior).
Aumenta la memoria PHP a 256M o 512M.
Configura el correo SMTP para evitar problemas de envío.
Si todo falla, restaura una copia de seguridad desde Syspanel.

Espero que esta FAQ te haya sido de gran ayuda. Recuerda que Syspanel (tu acceso por el puerto 2106) es una herramienta muy potente para gestionar tu hosting. Si después de seguir estos pasos el problema persiste, no dudes en abrir un ticket con nosotros, pero incluye siempre el error exacto que ves. ¡Así te ayudamos mucho más rápido!

¡Buena suerte con tu tienda!