Errores en PrestaShop tras migrar: Soluciones prácticas y rápidas

Antes de Empezar: Entendiendo el Problema

Migrar una tienda PrestaShop a un nuevo hosting es como mudarte de casa: todo está en cajas, y aunque hayas etiquetado cada una, siempre existe la posibilidad de que algo se rompa o no encuentres el enchufe correcto. Es un proceso delicado, pero con la guía adecuada, puedes resolver los errores PrestaShop migración sin volverte loco.

En este artículo, voy a explicarte paso a paso cómo solucionar los fallos más comunes que aparecen en PrestaShop después de migrar. No necesitas ser un experto en programación; solo sigue las instrucciones, respira hondo y vamos a ello. Al final, tendrás tu tienda funcionando más rápido que nunca.

¿Por Qué Aparecen Errores Tras Migrar?

Antes de lanzarnos a las soluciones, es importante entender el "porqué". Cuando cambias de servidor, cambian varias cosas a la vez: la versión de PHP, la configuración de la base de datos, las rutas de los archivos y los permisos. Cualquiera de estos cambios puede provocar que tu tienda no cargue o muestre pantallas en blanco.

La buena noticia es que la mayoría de estos problemas tienen soluciones sencillas. Vamos a verlas una por una.

Error 1: Pantalla en Blanco o "Error 500"

Este es, sin duda, el error más aterrador porque no te da ninguna pista. Simplemente ves una página blanca o un mensaje de "Internal Server Error".

¿Qué lo causa?

Generalmente, la causa es una configuración de PHP incorrecta o un archivo .htaccess corrupto. También puede deberse a que los permisos de los archivos no son los adecuados en el nuevo servidor.

Solución paso a paso

Activa el modo debug de PrestaShop: Esto te mostrará el error real en lugar de la pantalla blanca. Para ello, abre el archivo config/defines.inc.php y busca la línea que dice define('_PS_MODE_DEV_', false);. Cámbiala a define('_PS_MODE_DEV_', true);.
Regenera el archivo .htaccess: Ve a tu panel de administración de PrestaShop (si puedes acceder). Ve a Parámetros Avanzados > Rendimiento y haz clic en el botón "Guardar" sin cambiar nada. Esto fuerza la regeneración del .htaccess.
Revisa los permisos de archivos y carpetas: En tu servidor, las carpetas deben tener permiso 755 y los archivos 644. Si no sabes cómo hacerlo, usa el administrador de archivos de tu hosting o un cliente FTP como FileZilla. Selecciona todos los archivos y carpetas, haz clic derecho y busca "Permisos" o "CHMOD".

[INFO] Si usas el panel Syspanel (accesible en el puerto 2106), encontrarás el administrador de archivos en la sección "Archivos". Es muy intuitivo y te permite cambiar permisos con un clic.

Error 2: "Error de conexión a la base de datos"

Este error es muy claro: tu PrestaShop no puede hablar con su base de datos. Es como si tu tienda perdiera el teléfono con su almacén.

¿Qué lo causa?

Casi siempre es porque los datos de conexión en el archivo parameters.php no coinciden con los del nuevo hosting. Los nombres de usuario, contraseñas o el nombre de la base de datos suelen cambiar al migrar.

Solución paso a paso

Encuentra el archivo correcto: Navega a la carpeta app/config/ de tu instalación de PrestaShop y busca el archivo parameters.php.
Edita los datos: Ábrelo con un editor de texto (como el Bloc de notas) y busca las líneas que empiezan por 'database_host', 'database_name', 'database_user' y 'database_password'.
Introduce los nuevos valores: Estos datos te los proporciona tu nuevo proveedor de hosting. Normalmente están en el panel de control, en la sección de "Bases de datos MySQL". Si usas Syspanel, ve a la sección "Bases de datos" y ahí verás todos los detalles.

[WARNING] Asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre la base de datos. A veces, al crear el usuario, solo se le dan permisos de lectura y no de escritura. Esto te dará errores extraños y poco claros.

Error 3: La URL de la tienda sigue siendo la antigua

Has cambiado de dominio o de subdominio, pero PrestaShop sigue intentando cargar las imágenes y los enlaces desde la URL anterior. Esto es un clásico en PrestaShop después de migrar.

¿Qué lo causa?

PrestaShop guarda las URLs en la base de datos, no en archivos de configuración. Si no las actualizas, la tienda intentará buscar recursos en el dominio antiguo.

Solución paso a paso

Accede al panel de administración: Si la tienda carga aunque sea mal, intenta entrar a /admin (o la carpeta que hayas renombrado). Si no puedes, ve al paso 3.
Actualiza las URLs manualmente: Ve a Parámetros Avanzados > Rendimiento y en la sección "Configuración de URI" verás los campos "Dominio de la tienda" y "Dominio SSL". Cámbialos por tu nueva URL.
Si no puedes acceder al panel: Necesitarás editar la base de datos directamente. Usa phpMyAdmin desde tu panel de hosting (en Syspanel, lo encuentras en la sección "Bases de datos"). Busca la tabla ps_shop_url (el prefijo ps_ puede variar). Edita las columnas domain y domain_ssl con tu nueva URL.

[TIP] Después de cambiar la URL, es recomendable vaciar la caché de PrestaShop. Puedes hacerlo desde el panel de administración en Parámetros Avanzados > Rendimiento, o eliminando manualmente el contenido de la carpeta var/cache en el servidor.

Error 4: Imágenes rotas o que no cargan

Las imágenes de tus productos no se ven, aparecen como un icono de archivo roto. Esto es frustrante, pero tiene una solución clara.

¿Qué lo causa?

Suele ser por la regeneración de miniaturas. Al migrar, las imágenes redimensionadas (las que se crean en diferentes tamaños) pueden no haberse copiado correctamente o las rutas en la base de datos siguen siendo las antiguas.

Solución paso a paso

Asegúrate de que la carpeta img está completa: Verifica que la carpeta img en la raíz de tu PrestaShop esté completa y tenga los permisos adecuados (755 para carpetas, 644 para archivos).
Regenera las miniaturas: En tu panel de administración, ve a Diseño > Imágenes. Al final de la página, verás un botón que dice "Regenerar miniaturas". Haz clic en él. Esto puede tomar unos minutos, pero es muy efectivo.
Limpia la caché de imágenes: A veces, el navegador guarda las imágenes antiguas. Prueba a entrar en modo incógnito o borra la caché de tu navegador.

Error 5: Problemas con el módulo de pago o envío

Los módulos de terceros (pasarelas de pago, transportistas, etc.) suelen ser los más sensibles a los cambios de servidor. Es posible que dejen de funcionar correctamente.

¿Qué lo causa?

Estos módulos a menudo guardan configuraciones específicas del servidor (como rutas absolutas) o dependen de extensiones de PHP que no están habilitadas en el nuevo hosting.

Solución paso a paso

Revisa los requisitos del módulo: Ve a la página de descripción del módulo en la tienda de PrestaShop y verifica qué versiones de PHP y extensiones requiere.
Habilita las extensiones necesarias: En tu panel de control, busca la sección de "PHP" o "Configuración de PHP". Asegúrate de que las extensiones como curl, openssl, mbstring y gd están activadas. En Syspanel, esto se hace en la sección "Servidor" > "PHP".
Reinstala o actualiza el módulo: En el panel de administración de PrestaShop, ve a Módulos > Módulos y Servicios. Busca el módulo problemático y haz clic en "Desinstalar" y luego en "Instalar" de nuevo. Si hay una actualización disponible, instálala.

[WARNING] Antes de desinstalar un módulo de pago, asegúrate de tener guardadas las claves de API y la configuración. Desinstalarlo puede borrar la configuración, aunque generalmente los datos se guardan en la base de datos.

Error 6: La tienda funciona lenta

No es un "error" como tal, pero es un síntoma muy común después de una migración. La tienda va más lenta que antes y los clientes se quejan.

¿Qué lo causa?

Puede ser que el nuevo servidor tenga menos recursos, que la caché de PrestaShop no esté configurada correctamente, o que la versión de PHP no sea la óptima.

Solución paso a paso

Activa la caché de PrestaShop: Ve a Parámetros Avanzados > Rendimiento. Activa la caché y elige "Sistema de archivos" como método. También puedes activar la "Compresión CCC" para CSS y JavaScript.
Actualiza la versión de PHP: En tu panel de control, busca la opción de "Versión de PHP". Asegúrate de usar una versión compatible con tu PrestaShop (PHP 7.4 u 8.0 son buenas opciones para PrestaShop 1.7). En Syspanel, puedes cambiar la versión de PHP en la sección "Servidor" > "PHP".
Revisa el uso de recursos: Si tu hosting tiene un límite de memoria, puede que PrestaShop se quede corto. Intenta aumentar el memory_limit en el archivo php.ini o en la configuración del servidor.

[INFO] Un buen ajuste es cambiar el valor de memory_limit a al menos 256M. Esto le da a PrestaShop suficiente memoria para manejar procesos complejos como la generación de PDFs o el procesamiento de imágenes.

Preguntas Frecuentes (FAQ)

¿Cuánto tiempo tarda en propagarse el DNS después de migrar?

La propagación de DNS puede tardar entre 24 y 72 horas. Durante este tiempo, algunos usuarios verán tu nueva web y otros la antigua. Es normal y no es un error de PrestaShop.

¿Debo cambiar las contraseñas después de migrar?

Sí, es una buena práctica de seguridad. Cambia la contraseña del administrador de PrestaShop, la de la base de datos y la del panel de control de tu hosting.

¿Qué hago si pierdo el acceso al panel de administración?

Si no puedes acceder a /admin, puedes restablecer la contraseña directamente en la base de datos con phpMyAdmin. Busca la tabla ps_employee y edita el campo passwd. Debes generar un hash MD5 de tu nueva contraseña y pegarlo ahí. Puedes generar el hash en cualquier sitio web que ofrezca "MD5 generator".

¿Es recomendable usar un plugin de migración?

Sí, hay herramientas como "PrestaShop Migration" que automatizan gran parte del proceso. Sin embargo, es fundamental revisar los pasos de este artículo después de usarlas, ya que no son infalibles.

¿Qué pasa si mi tienda es muy grande?

Para tiendas grandes, te recomiendo hacer la migración en horario de baja afluencia y hacer una copia de seguridad completa (archivos y base de datos) antes de empezar. Si el proceso falla, siempre puedes restaurar.

Consejos Finales para una Migración Exitosa

Para evitar la mayoría de los errores PrestaShop migración, te sugiero que sigas esta checklist antes de dar el salto:

Haz una copia de seguridad completa de tus archivos y base de datos.
Anota la versión de PHP que usabas en el hosting antiguo. Intenta usar la misma en el nuevo para evitar sorpresas.
Descarga una copia de tu base de datos y guárdala en tu ordenador. Nunca está de más tener un plan B.
Revisa la configuración de PHP en el nuevo hosting y asegúrate de que las extensiones necesarias están activadas.
Desactiva la caché en tu PrestaShop antes de hacer la migración. Así evitarás que se copien archivos de caché corruptos.

Migrar de hosting no tiene por qué ser una pesadilla. Con un poco de paciencia y siguiendo estos pasos, podrás resolver cualquier solución errores PrestaShop que se te presente. Recuerda que la clave está en revisar la configuración de la base de datos, los permisos de archivos y la versión de PHP.

Si después de todo esto sigues teniendo problemas, no dudes en contactar con el soporte técnico de tu nuevo hosting. Ellos conocen su infraestructura y pueden darte una ayuda más específica. Mucha suerte con tu migrar hosting PrestaShop y que tus ventas sigan creciendo.