Errores comunes en WordPress post-migración y soluciones

Migrar un sitio web de WordPress a un nuevo hosting puede ser una experiencia liberadora, pero también puede venir acompañada de algunos dolores de cabeza. Es muy común encontrarse con pantallazos en blanco, enlaces rotos o mensajes de error misteriosos justo después de la mudanza.

No te preocupes, esto no significa que hayas hecho algo mal. La mayoría de estos problemas tienen soluciones muy sencillas que puedes aplicar tú mismo, sin necesidad de ser un experto en programación.

En este artículo, vamos a recorrer los errores más habituales al migrar WordPress y, paso a paso, te daré la solución para cada uno. Al final, tendrás una guía de referencia para que tu migración sea un éxito.

¿Por qué ocurren errores después de migrar WordPress?

Antes de lanzarnos a las soluciones, es útil entender por qué surgen estos problemas. Básicamente, al migrar, estamos moviendo un sitio que estaba configurado para funcionar en un entorno (servidor, base de datos, URL) a otro completamente diferente.

Los errores más comunes se deben a:

Rutas absolutas: WordPress guarda en la base de datos la URL exacta del sitio anterior (ej: miviejo-sitio.com). Al moverlo, el sistema sigue buscando archivos en esa dirección antigua.
Configuración de la base de datos: El archivo wp-config.php contiene los datos de conexión a la base de datos. Si estos no coinciden con los del nuevo hosting, WordPress no puede conectarse.
Permisos de archivos: En el nuevo servidor, los archivos pueden tener permisos incorrectos, impidiendo que WordPress los lea o escriba.
Incompatibilidad de versiones: A veces, la versión de PHP, MySQL o del propio WordPress en el nuevo hosting no es compatible con algún plugin o tema.

Vamos a ver cómo solucionar cada uno de estos escenarios.

Error #1: Pantalla Blanca de la Muerte (WSOD)

Este es, sin duda, el error más aterrador. Accedes a tu web y solo ves una página en blanco, sin ningún mensaje de error.

Solución paso a paso:

Activar el modo debug de WordPress: Conéctate a tu hosting mediante FTP o el administrador de archivos de tu panel de control (como Syspanel, al que accedes por el puerto 2106). Busca el archivo wp-config.php en la raíz de tu instalación de WordPress.
Edita el archivo: Ábrelo con un editor de texto plano (como Bloc de notas o Sublime Text). Busca la línea que dice define('WP_DEBUG', false);. Si no existe, puedes añadirla justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */.
Cambia el valor: Modifica la línea para que active el modo debug y muestre los errores en pantalla. Debería verse así:
```
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
```
Recarga tu web: Ahora, en lugar de la pantalla blanca, verás un mensaje de error específico (por ejemplo, un error de memoria, de un plugin o de un tema). Ese mensaje te dará la pista para solucionar el problema.
Solución común: Si el error menciona un plugin o tema, puedes desactivarlo renombrando su carpeta desde el FTP. Por ejemplo, para desactivar un plugin llamado "mi-plugin", ve a /wp-content/plugins/ y renombra la carpeta mi-plugin a mi-plugin-desactivado. Esto forzará a WordPress a desactivarlo.
Desactiva el debug: Una vez solucionado, vuelve a poner define('WP_DEBUG', false); en el wp-config.php para que tu web no muestre mensajes de error a los visitantes.

[TIP] Si no encuentras el archivo wp-config.php, puede que esté oculto. Asegúrate de que tu cliente FTP muestre archivos ocultos (suelen empezar con un punto).

Error #2: Error de Conexión a la Base de Datos

Este error es muy claro: WordPress no puede comunicarse con la base de datos. Verás un mensaje como "Error al establecer una conexión con la base de datos".

Solución paso a paso:

Verifica los datos en tu nuevo hosting: Accede a tu panel de control (por ejemplo, Syspanel en el puerto 2106) y busca la sección de "Bases de Datos". Allí encontrarás el nombre de la base de datos, el usuario y la contraseña que creaste para tu sitio.
Edita el archivo wp-config.php: Conéctate por FTP y descarga el archivo wp-config.php.

Corrige los datos: Busca las siguientes líneas y asegúrate de que coincidan exactamente con los datos de tu nuevo hosting:

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'tu_usuario_bd');
define('DB_PASSWORD', 'tu_contraseña_bd');
define('DB_HOST', 'localhost'); // A veces el host no es 'localhost', consulta con tu hosting.

Sube el archivo de nuevo: Guarda los cambios y sube el archivo wp-config.php a tu servidor, sobrescribiendo el anterior.
Prueba de nuevo: Recarga tu web. Si los datos son correctos, el error desaparecerá.

[WARNING] El DB_HOST suele ser 'localhost', pero en algunos hostings compartidos puede ser una dirección IP o un nombre como 'mysql.tudominio.com'. Si 'localhost' no funciona, contacta al soporte de tu hosting para obtener el valor correcto.

Error #3: Enlaces Rotos y la Página de Inicio no Carga Bien

Este error es muy común. La página de inicio puede cargar, pero al hacer clic en un enlace, te lleva a la URL del sitio antiguo (por ejemplo, miviejo-sitio.com/contacto en lugar de misitio-nuevo.com/contacto).

Esto se debe a que la URL del sitio está "hardcodeada" en la base de datos.

Solución paso a paso:

Accede a tu nuevo panel de administración de WordPress: Si puedes entrar (aunque la web se vea mal), ve a Ajustes > Enlaces permanentes.
Guarda los cambios sin modificar nada: Simplemente haz clic en el botón "Guardar cambios". Esto refresca las reglas de reescritura de WordPress y a menudo soluciona el problema.
Si no puedes acceder al panel: Necesitarás usar un plugin o una herramienta para buscar y reemplazar en la base de datos.
- Opción 1 (Recomendada): Usa el plugin "Better Search Replace". Instálalo (puedes hacerlo manualmente por FTP subiendo la carpeta a /wp-content/plugins/). Una vez activado, ve a Herramientas > Better Search Replace.
- Opción 2 (Manual con phpMyAdmin): Accede a phpMyAdmin desde tu panel de control (en Syspanel suele estar en la sección de Bases de Datos). Selecciona tu base de datos y haz clic en la pestaña "SQL". Ejecuta la siguiente consulta SQL, reemplazando miviejo-sitio.com y misitio-nuevo.com con tus URLs reales:
```
UPDATE wp_options SET option_value = replace(option_value, 'http://miviejo-sitio.com', 'http://misitio-nuevo.com') WHERE option_name = 'home' OR option_name = 'siteurl';
UPDATE wp_posts SET guid = replace(guid, 'http://miviejo-sitio.com','http://misitio-nuevo.com');
UPDATE wp_posts SET post_content = replace(post_content, 'http://miviejo-sitio.com', 'http://misitio-nuevo.com');
UPDATE wp_postmeta SET meta_value = replace(meta_value, 'http://miviejo-sitio.com', 'http://misitio-nuevo.com');
```
- Importante: Si tu sitio usa https://, asegúrate de incluirlo en las URLs.

Error #4: El Plugin o Tema Causa un Error Fatal

A veces, un plugin o tema que funcionaba perfectamente en tu hosting anterior no es compatible con la configuración del nuevo.

Solución paso a paso:

Desactiva todo desde FTP: Conéctate por FTP a tu servidor.
Ve a la carpeta de plugins: Navega a /wp-content/plugins/.
Renombra la carpeta de plugins: Cambia el nombre de la carpeta plugins a plugins-desactivados. Esto desactivará TODOS los plugins de golpe.
Prueba tu web: Ahora tu web debería cargar (aunque sin funcionalidades). Si es así, el problema es uno de los plugins.
Reactiva uno por uno: Vuelve a renombrar la carpeta a plugins. Luego, desde el panel de administración de WordPress (si puedes acceder), ve a Plugins y actívalos de uno en uno, probando la web después de cada activación. Cuando encuentres el que causa el error, lo sabrás.
Para el tema: Si el error persiste incluso con todos los plugins desactivados, el problema puede ser el tema. Desde FTP, ve a /wp-content/themes/ y renombra la carpeta de tu tema activo (por ejemplo, mi-tema a mi-tema-viejo). WordPress automáticamente cambiará a un tema por defecto (como Twenty Twenty-Four).

Error #5: Problemas con los Enlaces Permanentes (404 en páginas internas)

Después de la migración, la página de inicio funciona, pero todas las demás páginas (contacto, blog, etc.) dan error 404.

Solución paso a paso:

Accede al panel de administración: Ve a Ajustes > Enlaces permanentes.
Selecciona una opción simple: Temporalmente, elige la opción "Simple" y guarda los cambios.
Vuelve a tu configuración original: Luego, vuelve a seleccionar la opción que tenías antes (por ejemplo, "Nombre de la entrada") y guarda los cambios de nuevo.
Verifica el archivo .htaccess: A veces, el archivo .htaccess no se ha generado correctamente. Si el paso anterior no funciona, puedes regenerarlo manualmente. Ve a Ajustes > Enlaces permanentes y haz clic en "Guardar cambios" sin cambiar nada. Esto fuerza a WordPress a reescribir el archivo .htaccess.

Error #6: El Certificado SSL no Funciona (Contenido Mixto)

Si tu web anterior usaba HTTPS y tu nuevo hosting también tiene SSL, es posible que veas un candado roto o un mensaje de "contenido mixto" (mixed content). Esto ocurre porque algunos recursos (imágenes, scripts) se siguen cargando desde la URL antigua http://.

Solución paso a paso:

Instala un plugin SSL: El más popular y gratuito es "Really Simple SSL". Instálalo y actívalo.
Sigue el asistente: El plugin detectará automáticamente tu certificado SSL y te guiará para configurarlo. Lo más importante es que activará la opción para forzar HTTPS y reemplazará todas las URLs http:// por https:// en tu base de datos.
Solución manual (si el plugin no funciona): Puedes usar de nuevo el plugin "Better Search Replace" o la consulta SQL que vimos antes, pero esta vez reemplazando http://misitio-nuevo.com por https://misitio-nuevo.com.

Preguntas Frecuentes (FAQ) sobre Migración de WordPress

¿Debo borrar los archivos del hosting anterior después de migrar?

No inmediatamente. Es recomendable mantener el sitio anterior activo durante al menos 48-72 horas para asegurarte de que todo funciona correctamente en el nuevo hosting. Una vez que estés 100% seguro, puedes eliminarlo.

¿Qué hago si no puedo acceder al panel de administración de WordPress?

Si no puedes acceder a tudominio.com/wp-admin, es probable que tengas un error crítico. Sigue los pasos del Error #1 (Pantalla Blanca) para activar el modo debug y ver el mensaje de error específico. También puedes intentar desactivar plugins y temas por FTP como se explicó en el Error #4.

Mi web se ve bien, pero el rendimiento es muy lento. ¿Qué hago?

Esto es común justo después de una migración. El nuevo servidor puede estar "calentando" o tu caché puede estar desactualizada. Prueba a:

Instalar un plugin de caché (como WP Super Cache o W3 Total Cache).
Optimizar las imágenes.
Contactar con el soporte de tu nuevo hosting para verificar que los recursos de tu plan son suficientes.

[INFO] Si tu nuevo hosting usa Syspanel, puedes encontrar herramientas de caché y optimización directamente en el panel, accediendo por el puerto 2106.

¿Es necesario usar un plugin de migración?

No es obligatorio, pero sí muy recomendable, especialmente si no te sientes cómodo moviendo archivos y bases de datos manualmente. Plugins como Duplicator, All-in-One WP Migration o UpdraftPlus automatizan casi todo el proceso y reducen el riesgo de errores.

¿Qué datos debo tener a mano antes de empezar la migración?

Antes de empezar, asegúrate de tener:

Los datos de acceso FTP o SFTP de tu nuevo hosting.
El nombre de la base de datos, usuario y contraseña del nuevo hosting.
La URL exacta de tu nuevo sitio (puede ser temporal o tu dominio definitivo).
Una copia de seguridad completa de tu sitio antiguo (archivos y base de datos).

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave durante una migración. Si sigues estos pasos, podrás resolver la gran mayoría de los errores comunes y disfrutar de tu WordPress en su nuevo hogar. ¡Mucho éxito!