Errores migración WordPress a Syspanel: Soluciones prácticas

Migrar un sitio web de WordPress a un nuevo panel de control puede parecer una tarea compleja, pero con la guía adecuada, es un proceso sencillo y seguro. En este artículo, vamos a repasar los errores más comunes al migrar WordPress a Syspanel y, lo más importante, cómo solucionarlos paso a paso.

Syspanel (basado en el conocido panel HestiaCP, y accesible a través del puerto 2106) es una excelente opción para gestionar tu hosting. Sin embargo, durante la migración pueden surgir problemas típicos que, si no se identifican a tiempo, pueden dejar tu web caída o con un rendimiento pobre.

[INFO] Antes de empezar, recuerda que Syspanel se gestiona desde tu navegador en la dirección https://tudominio.com:2106. Ten siempre a mano tus credenciales de acceso.

A continuación, desglosamos los errores migración WordPress más frecuentes y sus soluciones prácticas para que puedas solucionar problemas Syspanel de forma autónoma.

Error 1: Base de datos no importada correctamente

Este es, sin duda, el error más común. Al migrar WordPress, la base de datos contiene toda tu información: entradas, páginas, usuarios y configuraciones. Si no se importa bien, tu web mostrará un mensaje de "Error al establecer conexión con la base de datos".

¿Por qué ocurre?

El archivo SQL exportado es demasiado grande y el gestor de Syspanel lo corta.
La codificación del archivo no es la correcta (UTF-8).
No se creó la base de datos y el usuario antes de importar.

¿Cómo solucionarlo?

Crea la base de datos y el usuario en Syspanel:
- Accede a Syspanel (puerto 2106).
- Ve a Base de datos y haz clic en Añadir base de datos.
- Anota el nombre de la base de datos, el usuario y la contraseña. Guarda estos datos, los necesitarás después.
Exporta tu base de datos original desde tu panel anterior (cPanel, Plesk, etc.):
- Usa phpMyAdmin o la herramienta de exportación de tu hosting.
- Selecciona Exportar rápido y formato SQL.
Importa el archivo SQL en Syspanel:
- En Syspanel, ve a phpMyAdmin (suele estar en el menú de Base de datos).
- Selecciona la base de datos que creaste.
- Haz clic en Importar y sube el archivo SQL.

[WARNING] Si el archivo SQL es mayor de 50 MB, es probable que la importación falle. En ese caso, usa la herramienta de línea de comandos o divide el archivo en partes más pequeñas. Si no sabes cómo, contacta con soporte técnico.

Error 2: Archivos de WordPress incompletos o mal subidos

Otro clásico es subir los archivos del sitio (carpeta wp-content, wp-admin, etc.) de forma incorrecta. Esto provoca que la web se vea en blanco, con estilos rotos o que falten plugins.

¿Por qué ocurre?

Subir los archivos a la carpeta equivocada dentro de Syspanel.
No comprimir los archivos en un ZIP antes de subirlos.
Olvidar incluir la carpeta wp-content/uploads (donde están las imágenes).

¿Cómo solucionarlo?

Descarga todos los archivos de tu WordPress actual:
- Conéctate por FTP a tu hosting anterior o descarga una copia de seguridad desde el panel.
- Asegúrate de incluir toda la carpeta raíz de WordPress (normalmente public_html).
Comprime todo en un archivo ZIP:
- Esto acelera la subida y evita errores de conexión.
Sube el ZIP a Syspanel:
- En Syspanel, ve a Administrador de archivos (o File Manager).
- Navega hasta la carpeta public_html de tu dominio.
- Sube el archivo ZIP.
Descomprime el ZIP:
- Selecciona el archivo y haz clic en Extraer.
- Asegúrate de que los archivos queden directamente en public_html, no dentro de una subcarpeta.

[TIP] Si tu web tiene muchas imágenes, la subida puede tardar. Usa un cliente FTP (como FileZilla) conectado a Syspanel (puerto 21) para mayor estabilidad.

Error 3: Archivo wp-config.php con datos incorrectos

El archivo wp-config.php es el corazón de WordPress. Si contiene credenciales antiguas de la base de datos, la web no podrá conectarse.

¿Por qué ocurre?

Copiaste el archivo desde el hosting anterior sin actualizar los datos.
Los nombres de base de datos, usuario o contraseña son diferentes en Syspanel.

¿Cómo solucionarlo?

Localiza el archivo wp-config.php en la carpeta raíz de tu WordPress (dentro de public_html).
Edítalo con el Administrador de archivos de Syspanel o con un editor de texto.

Reemplaza estas líneas con los datos de tu nueva base de datos:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_de_la_base');
define('DB_HOST', 'localhost');

[INFO] En Syspanel, el servidor de base de datos suele ser localhost. Si usas un servidor remoto, cámbialo por la IP correspondiente.

Guarda los cambios y cierra el archivo.

Error 4: URLs antiguas en la base de datos (causa de enlaces rotos)

Después de migrar, es muy común que los enlaces internos de tu web sigan apuntando al dominio anterior. Esto genera páginas 404 y contenido que no se muestra.

¿Por qué ocurre?

WordPress almacena las URLs completas en la base de datos (en tablas como wp_options y wp_posts).
Al cambiar de dominio o de subdominio, esas URLs quedan desactualizadas.

¿Cómo solucionarlo?

Existen dos métodos: usando un plugin o mediante SQL directo.

Método 1: Usa un plugin (recomendado para principiantes)

Instala el plugin Better Search Replace o Velvet Blues Update URLs.
Ve a Herramientas > Better Search Replace.
En Buscar, escribe la URL antigua (ej: http://antiguodominio.com).
En Reemplazar, escribe la nueva URL (ej: http://nuevodominio.com).
Selecciona todas las tablas de la base de datos.
Haz clic en Ejecutar.

Método 2: Consulta SQL directa (avanzado)

Accede a phpMyAdmin en Syspanel.
Selecciona tu base de datos.

Ve a la pestaña SQL y ejecuta:

UPDATE wp_options SET option_value = REPLACE(option_value, 'http://antiguodominio.com', 'http://nuevodominio.com') WHERE option_name = 'home' OR option_name = 'siteurl';
UPDATE wp_posts SET post_content = REPLACE(post_content, 'http://antiguodominio.com', 'http://nuevodominio.com');
UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'http://antiguodominio.com', 'http://nuevodominio.com');

(Reemplaza antiguodominio.com y nuevodominio.com por tus URLs reales.)

[WARNING] Haz siempre una copia de seguridad de la base de datos antes de ejecutar consultas SQL. Un error podría borrar toda tu información.

Error 5: Permisos de archivos incorrectos

Los archivos y carpetas en Syspanel necesitan permisos específicos para que WordPress pueda leer, escribir y ejecutarlos. Si están mal configurados, pueden aparecer errores como "No se puede crear el directorio wp-content/uploads" o la web se vuelve de solo lectura.

¿Por qué ocurre?

Al subir archivos desde otro panel, los permisos se copian incorrectamente.
Al descomprimir un ZIP, los permisos pueden quedar en 755 o 644, pero a veces fallan.

¿Cómo solucionarlo?

Conéctate a Syspanel por FTP o usa el Administrador de archivos.
Navega a la carpeta public_html donde está tu WordPress.
Aplica estos permisos estándar:
- Carpetas: 755 (rwxr-xr-x)
- Archivos: 644 (rw-r--r--)
- Archivo wp-config.php: 600 (rw-------) para mayor seguridad.
Cómo cambiarlos en el Administrador de archivos:
- Selecciona todos los archivos y carpetas.
- Haz clic derecho y elige Permisos.
- Introduce 755 para carpetas y 644 para archivos (puedes hacerlo por separado).
- Marca la opción Recursivo para aplicar a subcarpetas.

[TIP] Si usas FTP, muchos clientes permiten cambiar permisos en lote. En FileZilla, selecciona todo, haz clic derecho > Permisos de archivos e introduce el número.

Error 6: Certificado SSL no configurado (web marcada como "No segura")

Después de migrar, es posible que tu web cargue sin HTTPS o que el navegador muestre un aviso de seguridad. Esto afecta al SEO y a la confianza de los visitantes.

¿Por qué ocurre?

Syspanel no tiene un certificado SSL activo para tu dominio.
Las URLs en la base de datos siguen usando HTTP en lugar de HTTPS.

¿Cómo solucionarlo?

Activa SSL gratuito en Syspanel:
- Ve a Web > SSL en tu dominio.
- Selecciona Let's Encrypt.
- Marca la opción Forzar HTTPS.
- Haz clic en Guardar y espera unos segundos a que se emita el certificado.
Actualiza las URLs en WordPress:
- Si ya cambiaste las URLs en el paso del Error 4, asegúrate de que ahora usen https://.
- Ve a Ajustes > Generales en tu WordPress y verifica que la dirección de WordPress y la del sitio comiencen con https://.
Corrige contenido mixto (HTTP en HTTPS):
- Instala el plugin Really Simple SSL. Detecta y corrige automáticamente los enlaces mixtos.

[INFO] Si tu web ya tenía SSL antes de migrar, es posible que necesites regenerar el certificado en Syspanel, ya que el anterior está vinculado al servidor antiguo.

Error 7: Problemas con el archivo .htaccess (enlaces permanentes rotos)

Después de la migración, es posible que las páginas internas (como /blog/mi-articulo) den error 404. Esto se debe a que las reglas de reescritura de URLs no se han actualizado.

¿Por qué ocurre?

El archivo .htaccess no se copió correctamente.
Las reglas de reescritura son incompatibles con la configuración de Syspanel.

¿Cómo solucionarlo?

Genera un nuevo .htaccess desde WordPress:
- Ve a Ajustes > Enlaces permanentes en tu administrador de WordPress.
- Sin hacer ningún cambio, haz clic en Guardar cambios. Esto regenera el archivo .htaccess automáticamente.

Si aún falla, crea un .htaccess manual:

Conéctate por FTP o al Administrador de archivos.
En la carpeta raíz, crea un archivo llamado .htaccess (sin extensión).

Pega este contenido básico:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

[WARNING] Nunca edites el .htaccess con un editor de texto normal que pueda añadir saltos de línea extraños. Usa siempre el editor de Syspanel o un cliente FTP.

Error 8: Olvidar cambiar el DNS del dominio

Este error es muy común cuando migras a un nuevo servidor. Aunque hayas subido todo correctamente a Syspanel, si tu dominio sigue apuntando al hosting antiguo, los visitantes verán la web vieja.

¿Por qué ocurre?

No actualizaste los servidores DNS (nameservers) de tu dominio.
El TTL (tiempo de vida) del DNS anterior sigue activo (puede tardar hasta 48 horas en propagarse).

¿Cómo solucionarlo?

Obtén los servidores DNS de Syspanel:
- En Syspanel, ve a DNS o Configuración de dominio.
- Anota los dos nameservers que te proporciona (ej: ns1.syspanel.com y ns2.syspanel.com).
Cambia los DNS en tu registrador de dominios:
- Accede a donde compraste tu dominio (GoDaddy, Namecheap, etc.).
- Busca la opción de Nameservers o Servidores DNS.
- Reemplaza los antiguos por los de Syspanel.
Espera la propagación:
- El cambio puede tardar desde 10 minutos hasta 48 horas. Mientras tanto, puedes acceder a tu web temporalmente usando la IP del servidor de Syspanel (pregunta a soporte).

[TIP] Para probar tu web antes de que se propaguen los DNS, edita el archivo hosts de tu computadora. En Windows, está en C:\Windows\System32\drivers\etc\hosts. Añade una línea con la IP de Syspanel y tu dominio (ej: 192.168.1.1 tudominio.com). Esto es solo para pruebas locales.

Preguntas Frecuentes (FAQ) sobre migrar WordPress a Syspanel

1. ¿Puedo migrar un WordPress de gran tamaño (más de 1 GB)?

Sí, pero es recomendable usar FTP o SCP para subir los archivos, ya que el Administrador de archivos tiene límites de tamaño. Para la base de datos, usa la importación por partes o la línea de comandos.

2. ¿Qué hago si después de la migración la web se ve en blanco?

Generalmente es un error de PHP o de memoria. Activa la depuración en WordPress editando wp-config.php y añadiendo:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

Luego revisa el archivo wp-content/debug.log para ver el error exacto.

3. ¿Syspanel tiene algún límite de plugins o temas?

No, Syspanel no limita los plugins o temas que puedes instalar. Sin embargo, el rendimiento depende de los recursos de tu plan de hosting.

4. ¿Pierdo el SEO al migrar?

Si sigues los pasos correctos (actualizar URLs, redirigir 301, mantener la estructura de enlaces), no deberías perder posicionamiento. Usa herramientas como Google Search Console para monitorear.

5. ¿Necesito ayuda profesional?

Si te sientes inseguro, siempre puedes contratar el servicio de migración de Syspanel. Pero con esta guía, la mayoría de usuarios pueden hacerlo por sí mismos.

Conclusión

Migrar WordPress a Syspanel no tiene por qué ser un dolor de cabeza. Los errores migración WordPress más comunes tienen solución y, con un poco de paciencia, puedes tener tu web funcionando en pocas horas. Recuerda siempre:

Hacer copias de seguridad completas (archivos + base de datos).
Verificar las credenciales de la base de datos en wp-config.php.
Actualizar las URLs después de la migración.
Configurar SSL y DNS correctamente.

Si encuentras algún problema que no cubrimos aquí, no dudes en consultar la documentación oficial de Syspanel o contactar con su soporte técnico. ¡Buena suerte con tu migración!