Errores comunes en PrestaShop al migrar hosting | FAQ

Cambiar de hosting es como mudarse de casa: emocionante porque ganas más espacio y mejor rendimiento, pero estresante si algo sale mal durante el traslado. En el mundo de PrestaShop, esta mudanza puede traer algunos dolores de cabeza si no se hace con cuidado. Los errores PrestaShop hosting más comunes suelen aparecer justo después de la migración: pantallas en blanco, bases de datos que no conectan, imágenes rotas o la temida página de error 500.

No te preocupes. En esta guía extensa y muy práctica, vamos a desglosar cada uno de estos problemas, explicarte por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Tanto si usas PrestaShop cPanel, PrestaShop Plesk o cualquier otro panel, aquí encontrarás la solución. Vamos a ello.

Antes de empezar: la preparación evita el 90% de los errores

Antes de siquiera pensar en tocar los archivos, asegúrate de tener una copia de seguridad completa de tu tienda. Esto incluye:

Archivos del sitio (la carpeta raíz de PrestaShop).
Base de datos (exportada en SQL).
Archivos de configuración (especialmente /app/config/parameters.php).

[WARNING] Nunca empieces una migración sin verificar que la copia de seguridad se ha descargado correctamente y pesa lo esperado. Una copia corrupta es la causa número uno de errores posteriores.

Error 1: Pantalla blanca o error 500 después de la migración

Este es, con diferencia, el error PrestaShop hosting más temido. La pantalla en blanco (también llamada "White Screen of Death") suele deberse a un problema de PHP o de permisos de archivos.

¿Por qué ocurre?

La versión de PHP en el nuevo hosting no es compatible con tu versión de PrestaShop.
Los archivos no se han subido correctamente (se han perdido archivos críticos).
Los permisos de carpetas y archivos son incorrectos.
El archivo .htaccess no se ha regenerado.

Solución paso a paso

Verifica la versión de PHP: Entra en el panel de control de tu hosting (cPanel, Plesk o Syspanel). Busca la sección "Select PHP Version" o "PHP Settings". Asegúrate de que la versión sea la recomendada para tu PrestaShop (normalmente 7.4, 8.0 u 8.1). Si no sabes cuál usar, prueba con 7.4, que es muy estable.
Aumenta el límite de memoria de PHP: En la misma sección, busca el parámetro memory_limit y ponlo al menos en 256M. También ajusta max_execution_time a 300 y upload_max_filesize a 64M.
Verifica los permisos de archivos: Conéctate por FTP o desde el administrador de archivos del panel. Las carpetas deben tener permisos 755 y los archivos 644. La carpeta cache y log deben tener permisos 777 temporalmente para que PrestaShop pueda escribir en ellas.
Borra la cache de PrestaShop: Ve a la carpeta /var/cache/ y elimina todo su contenido (excepto la carpeta dev si existe). Luego, elimina el archivo /config/xml/themes.xml (se regenerará solo).
Regenera el .htaccess: Ve a tu panel de administración de PrestaShop (si puedes acceder) a Parámetros de la tienda > Tráfico y SEO > SEO y URLs. Sin cambiar nada, haz clic en "Guardar". Esto regenera el archivo.

[TIP] Si no puedes acceder al panel de administración, renombra el archivo .htaccess a .htaccess_old y luego intenta acceder a la tienda. Si funciona, el problema estaba en ese archivo.

Error 2: "Base de datos no encontrada" o error de conexión

Este error aparece cuando los datos de conexión a la base de datos no coinciden con los del nuevo hosting.

¿Por qué ocurre?

Has cambiado el nombre de la base de datos, el usuario o la contraseña.
La base de datos no se ha importado correctamente.
El servidor MySQL no permite conexiones desde ciertas IPs.

Solución paso a paso

Revisa el archivo parameters.php: Ve a /app/config/parameters.php. Debe contener los datos correctos de tu nueva base de datos. Los parámetros clave son:
- database_host (normalmente localhost, pero a veces el hosting te da un servidor específico).
- database_name
- database_user
- database_password
Verifica que la base de datos exista: Entra en phpMyAdmin (desde cPanel, Plesk o Syspanel) y asegúrate de que la base de datos con el nombre que pusiste existe y tiene tablas.
Importa de nuevo la base de datos: Si no tiene tablas o están vacías, importa el archivo SQL que exportaste. A veces el proceso de importación falla por el tamaño. Si es muy grande, usa la opción de importación por partes o hazlo desde la línea de comandos.

[INFO] En algunos hostings, el nombre de la base de datos se compone de usuario_nombrebd. Asegúrate de que en parameters.php aparece exactamente como te lo dio el hosting.

Error 3: Imágenes rotas o que no cargan

Después de migrar, es muy común que las imágenes de productos, categorías o módulos no se muestren. Verás un icono de imagen rota.

¿Por qué ocurre?

Las rutas de las imágenes son absolutas y apuntan al dominio antiguo.
La carpeta img no se ha subido completa.
Los permisos de la carpeta img y subcarpetas son incorrectos.

Solución paso a paso

Verifica la carpeta img: Conéctate por FTP y asegúrate de que la carpeta img y todas sus subcarpetas (como p, c, m, etc.) están completas. Compara el peso total con tu copia de seguridad.
Regenera las miniaturas: Desde el panel de administración de PrestaShop, ve a Parámetros de la tienda > Imágenes > Regenerar miniaturas. Selecciona "Todos" y ejecuta. Esto puede tardar varios minutos.
Corrige rutas en la base de datos: A veces, la base de datos guarda rutas absolutas. Usa phpMyAdmin y ejecuta una consulta SQL para reemplazar el dominio antiguo por el nuevo. Por ejemplo:
```
UPDATE ps_image_shop SET path = REPLACE(path, 'http://dominioantiguo.com', 'https://nuevodominio.com');
```
(Ajusta el prefijo ps_ si el tuyo es diferente).
Verifica el .htaccess: Si usas redirecciones o reglas de reescritura, asegúrate de que no están bloqueando las rutas de imágenes.

[TIP] Si tienes muchas imágenes, usa un módulo como "PrestaShop Cleaner" para regenerar todo en lote.

Error 4: Problemas con los módulos y temas después de la migración

Algunos módulos o el tema pueden dejar de funcionar correctamente en el nuevo hosting.

¿Por qué ocurre?

Los módulos dependen de extensiones de PHP que no están instaladas en el nuevo servidor.
El tema usa rutas absolutas.
Los archivos de configuración de módulos se han corrompido.

Solución paso a paso

Verifica las extensiones de PHP: En cPanel, busca "Select PHP Version" y asegúrate de que extensiones como curl, gd, mbstring, openssl, pdo_mysql, xml, zip estén habilitadas.
Desactiva y reactiva los módulos problemáticos: Ve a Módulos > Módulos y servicios en el panel de administración. Busca el módulo que falla, desactívalo y vuelve a activarlo. Si no puedes acceder al panel, renombra la carpeta del módulo en /modules/ (por ejemplo, añadiendo _old) y luego accede a la tienda. Esto lo desactivará forzosamente.
Reinstala el tema: Si el tema falla, sube de nuevo los archivos del tema desde cero. A veces, durante la migración por FTP se pierden archivos pequeños.
Limpia la cache de Smarty: Ve a Parámetros avanzados > Rendimiento y haz clic en "Forzar compilación" y "Vaciar cache". Guarda los cambios.

[WARNING] No fuerces la compilación en un entorno de producción permanente. Solo úsalo para pruebas y luego vuelve a desactivarlo.

Error 5: URL incorrectas o redirecciones infinitas

Después de migrar, puede que al escribir tu dominio te lleve a otro sitio, o que la tienda funcione pero las URLs internas sigan apuntando al antiguo hosting.

¿Por qué ocurre?

No has actualizado la URL de la tienda en la base de datos.
El archivo .htaccess tiene redirecciones del antiguo hosting.
El DNS aún no se ha propagado completamente.

Solución paso a paso

Cambia la URL en la base de datos: Entra en phpMyAdmin y busca la tabla ps_configuration (o como se llame tu prefijo). Busca las filas con name igual a PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL (si usas HTTPS). Cámbialas por tu nuevo dominio.
Actualiza la URL en la tabla ps_shop_url: En la misma base de datos, busca la tabla ps_shop_url y modifica los campos domain, domain_ssl y physical_uri si es necesario.
Borra el .htaccess y regenera: Como vimos antes, renombra el archivo .htaccess y luego desde el panel de administración regenera.
Espera la propagación DNS: Si cambiaste los servidores DNS, puede tardar hasta 48 horas. Durante ese tiempo, puedes editar el archivo hosts de tu ordenador para forzar la resolución al nuevo servidor y probar.

[INFO] Si usas Syspanel (HestiaCP), recuerda que el acceso al panel es por el puerto 2106. Una vez dentro, busca la sección de base de datos y DNS para hacer estos cambios.

Error 6: El carrito de compras no funciona o errores en el proceso de pago

Los errores en el carrito suelen aparecer cuando hay problemas con las sesiones o con la configuración de SSL.

¿Por qué ocurre?

Las sesiones de PHP no se guardan correctamente.
El certificado SSL no está bien instalado o hay contenido mixto (HTTP y HTTPS).
Algún módulo de pago no está configurado para el nuevo dominio.

Solución paso a paso

Verifica el SSL: Asegúrate de que tu nuevo hosting tiene un certificado SSL instalado y que tu tienda carga por HTTPS. Ve a Parámetros de la tienda > General y activa "SSL" y "SSL en todas las páginas".
Limpia las sesiones: En phpMyAdmin, vacía la tabla ps_connections y ps_connections_page. También puedes borrar los archivos temporales de sesión en la carpeta /var/sessions/.
Reconfigura los módulos de pago: Cada módulo de pago (PayPal, Stripe, etc.) tiene una configuración donde debes indicar la URL de tu tienda. Revisa que apunten a tu nuevo dominio.
Prueba con un módulo de pago por defecto: Temporalmente, activa el módulo de pago "Pago por transferencia bancaria" para ver si el problema es del módulo en sí o de la configuración general.

Error 7: El email de la tienda no se envía

Después de migrar, los correos de confirmación de pedido, recuperación de contraseña, etc., dejan de llegar.

¿Por qué ocurre?

La configuración SMTP no se ha actualizado.
El servidor de correo del nuevo hosting no permite envíos desde scripts.
Los registros SPF o DKIM no están configurados.

Solución paso a paso

Configura SMTP: En el panel de administración, ve a Parámetros avanzados > Email. Cambia de "Usar la función mail de PHP" a "Configurar SMTP manualmente". Introduce los datos del servidor de correo de tu nuevo hosting (suelen dártelos en la bienvenida).
Prueba el envío: En la misma página, escribe un email de prueba (puede ser el tuyo) y haz clic en "Enviar un email de prueba". Si no llega, revisa los datos SMTP.
Verifica los registros DNS: Si tu nuevo hosting te permite gestionar DNS, añade registros SPF y DKIM para mejorar la entregabilidad. Pide ayuda a tu proveedor si no sabes cómo.

[TIP] Si usas Syspanel (HestiaCP), el puerto 2106 te da acceso a la gestión de DNS y correo. Desde allí puedes configurar fácilmente los registros.

Preguntas frecuentes (FAQ) sobre errores PrestaShop hosting

¿Puedo migrar PrestaShop manualmente sin módulos?

Sí, es totalmente posible. Solo necesitas exportar la base de datos, copiar los archivos por FTP y ajustar el archivo parameters.php. Eso sí, requiere más cuidado. Si no te sientes seguro, usa un módulo de migración.

¿Qué hago si no recuerdo la contraseña de la base de datos antigua?

Puedes resetearla desde el panel de control de tu antiguo hosting (cPanel, Plesk, Syspanel). Si ya no tienes acceso, necesitarás contactar con el soporte del antiguo proveedor.

¿Es necesario cambiar el prefijo de las tablas de la base de datos?

No es necesario, pero si quieres hacerlo, puedes usar phpMyAdmin y renombrar las tablas. Luego deberás actualizar el parámetro database_prefix en parameters.php.

¿Por qué mi tienda en PrestaShop carga muy lento en el nuevo hosting?

Puede ser por la configuración de PHP (poca memoria), falta de caché (instala un módulo de caché como "cacherev" o "Advanced Cache") o porque el nuevo hosting tiene recursos limitados. Revisa el rendimiento en Parámetros avanzados > Rendimiento.

¿Syspanel (HestiaCP) es bueno para PrestaShop?

Sí, Syspanel (HestiaCP) es un panel de control ligero y muy eficiente. Recuerda que su puerto de acceso es el 2106. Ofrece gestión de bases de datos, DNS, correo y archivos. Es ideal para hostings de recursos medios. Si usas Syspanel, los pasos de configuración son similares a cPanel, solo cambian los nombres de las secciones.

Conclusión: La paciencia y el orden son tus mejores aliados

Migrar PrestaShop no tiene por qué ser una pesadilla. La mayoría de los errores PrestaShop hosting se solucionan con una buena copia de seguridad, verificando la versión de PHP, ajustando permisos y actualizando las URLs en la base de datos. Si sigues esta guía paso a paso, podrás migrar PrestaShop sin perder ventas ni datos.

Recuerda: antes de tocar nada, haz copia de seguridad. Después, ve probando cada paso. Y si algo falla, no dudes en consultar esta guía o preguntar a tu proveedor de hosting. ¡Tu tienda online volverá a funcionar como un reloj!