Problemas al migrar WordPress a Plesk - FAQ y soluciones

Introducción: ¿Por qué surgen problemas al migrar WordPress a Plesk?

Migrar un sitio web de WordPress de un servidor a otro, especialmente a Plesk, puede parecer un proceso sencillo, pero a menudo se convierte en una fuente de frustración. Los errores más comunes suelen estar relacionados con diferencias en la configuración del servidor, permisos de archivos, versiones de PHP o problemas con la base de datos. Este artículo es tu FAQ definitivo para resolver los problemas más frecuentes al migrar WordPress Plesk. Aquí encontrarás soluciones paso a paso, explicadas en un lenguaje claro y amigable, para que puedas completar tu migración sin dolores de cabeza.

[INFO] Si en algún momento necesitas acceder a un panel de control alternativo como Syspanel, recuerda que la dirección de acceso es tu-dominio.com:2106. Esto te puede ser útil si estás familiarizado con otras interfaces.

1. Error de conexión a la base de datos (Database Connection Error)

Este es, sin duda, el problema más común. Al mover tu WordPress a Plesk, las credenciales de la base de datos suelen cambiar (nombre de usuario, contraseña o nombre de la base de datos). El error típico es: "Error establishing a database connection".

Causas principales

Credenciales incorrectas en el archivo wp-config.php.
Base de datos no importada correctamente.
Usuario sin permisos sobre la base de datos en Plesk.

Solución paso a paso

Accede a Plesk y ve a la sección "Bases de datos".
Crea una base de datos nueva o verifica que la importada exista.
Asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) sobre esa base de datos.
Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress (dentro de httpdocs).

Edítalo y verifica estas líneas:

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_bd');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost'); // Normalmente localhost, pero puede ser otro servidor

Guarda los cambios y recarga tu sitio.

[TIP] En Plesk, el servidor de base de datos suele ser localhost. Si usas un servidor externo, cámbialo por la IP o nombre del host.

2. Página en blanco o error 500 después de la migración

Una página en blanco (Pantalla Blanca de la Muerte) o un error 500 interno del servidor indican un problema de PHP, permisos de archivos o un plugin/ tema incompatible.

Causas frecuentes

Versión de PHP incorrecta en Plesk.
Permisos de archivos y carpetas demasiado restrictivos.
Plugin o tema con código obsoleto que no es compatible con la nueva configuración.

Solución

Verifica la versión de PHP en Plesk: Ve a "Hosting & DNS" > "Configuración de hosting" y selecciona una versión moderna (7.4, 8.0 o 8.1, según tu WordPress).
Aumenta el límite de memoria de PHP temporalmente editando el wp-config.php:
```
define('WP_MEMORY_LIMIT', '256M');
```
Revisa los permisos: Las carpetas deben tener 755 y los archivos 644. En Plesk, puedes usar el Administrador de Archivos para corregirlos en masa.
Desactiva todos los plugins renombrando la carpeta wp-content/plugins a plugins_old. Si el sitio carga, reactiva uno por uno.

[WARNING] Si el error persiste, revisa los logs de error de Plesk en "Herramientas y utilidades" > "Registros de error". Busca líneas con "PHP Fatal error".

3. Enlaces rotos (imágenes, CSS, JS) después de migrar WordPress a Plesk

Al cambiar de dominio o de estructura de carpetas (por ejemplo, de /public_html a httpdocs en Plesk), las rutas absolutas en la base de datos dejan de funcionar. Esto provoca que las imágenes, estilos y scripts no carguen.

Síntomas

Imágenes con URL antigua (ej: http://old-dominio.com/wp-content/uploads/...).
Página sin diseño (solo texto).

Solución con un plugin (recomendado)

Instala el plugin Better Search Replace o Velvet Blues Update URLs.
Ve a la sección del plugin y en "Search for" escribe la URL anterior (ej: http://old-dominio.com).
En "Replace with" escribe la nueva URL (ej: http://new-dominio.com).
Marca todas las tablas de la base de datos y ejecuta el reemplazo.

Solución manual (sin plugin)

Si no puedes acceder al panel de administración, usa phpMyAdmin desde Plesk:

Selecciona tu base de datos.

Haz clic en "SQL" y ejecuta esta consulta (cambiando las URLs):

UPDATE wp_options SET option_value = REPLACE(option_value, 'http://old-dominio.com', 'http://new-dominio.com');
UPDATE wp_posts SET post_content = REPLACE(post_content, 'http://old-dominio.com', 'http://new-dominio.com');
UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'http://old-dominio.com', 'http://new-dominio.com');

[INFO] Si tu instalación usa un prefijo de tabla diferente a wp_, cámbialo en las consultas.

4. El sitio redirige al dominio antiguo

Este problema ocurre cuando la URL del sitio (definida en la base de datos) sigue apuntando al dominio anterior. Al escribir el nuevo dominio, el navegador te lleva automáticamente al viejo.

Causa

Las opciones siteurl y home en la tabla wp_options aún contienen la URL antigua.

Solución

Si tienes acceso al panel de administración (aunque sea con redirección), ve a Ajustes > Generales y cambia las dos URLs.
Si no tienes acceso, edita el wp-config.php y añade estas líneas ANTES de /* That's all, stop editing! */:
```
define('WP_HOME', 'http://nuevo-dominio.com');
define('WP_SITEURL', 'http://nuevo-dominio.com');
```
Guarda el archivo y recarga. Luego, una vez que accedas, retira esas líneas y guarda los cambios desde el panel.

5. Error "Failed to open stream: Permission denied" en Plesk

Este error suele aparecer cuando WordPress intenta escribir archivos (por ejemplo, al instalar plugins o temas) pero los permisos del sistema de archivos no lo permiten.

Causas

El usuario del sistema (generalmente www-data o apache) no tiene permisos de escritura en las carpetas wp-content, uploads, plugins o themes.
El propietario de los archivos no coincide con el usuario de Plesk.

Solución

En Plesk, ve a "Archivos" y navega a httpdocs.
Selecciona la carpeta wp-content y haz clic en "Permisos".
Marca la opción "Aplicar permisos a todos los subdirectorios y archivos".
Establece permisos 755 para directorios y 644 para archivos.
Si el problema persiste, desde el panel de Plesk ve a "Hosting & DNS" > "Configuración de hosting" y asegúrate de que "Permisos de archivos" esté configurado como "Seguro" (no "Estricto").

6. Problemas con el certificado SSL y contenido mixto

Si tu sitio anterior usaba HTTPS y ahora en Plesk el certificado no está configurado, o viceversa, puedes tener problemas de contenido mixto (mixed content).

Síntomas

El candado de seguridad aparece roto.
Algunos recursos (imágenes, scripts) se cargan con http:// en lugar de https://.

Solución

Instala un certificado SSL en Plesk: Ve a "Herramientas y utilidades" > "SSL/TLS".
Activa la redirección forzada a HTTPS en "Hosting & DNS" > "Configuración de hosting" > "Redirección a HTTPS".
Actualiza las URLs en la base de datos (como en el punto 3) pero reemplazando http:// por https://.
Usa un plugin como "Really Simple SSL" para corregir automáticamente el contenido mixto.

7. Migración incompleta: falta de archivos o base de datos

A veces, al usar plugins de migración (como All-in-One WP Migration) o al hacerlo manualmente, olvidamos algún archivo o tabla.

Síntomas

El sitio carga pero faltan páginas, imágenes o funcionalidades.
Aparecen errores como "Table not found" en la base de datos.

Solución

Verifica la integridad de la base de datos: Desde phpMyAdmin, exporta la base de datos original y compárala con la nueva. Asegúrate de que todas las tablas estén presentes.
Revisa la carpeta wp-content/uploads: Es la más pesada y a veces se omite. Sube toda la carpeta mediante FTP o el Administrador de Archivos de Plesk.
Si usaste un plugin de migración, asegúrate de que el archivo de respaldo esté completo. Vuelve a generar la exportación si es necesario.

[TIP] Para migraciones grandes, recomiendo usar Duplicator o UpdraftPlus, que generan un instalador que guía todo el proceso.

8. El plugin o tema no se activa o da error de "Headers already sent"

Este error aparece cuando hay espacios en blanco o caracteres extra al inicio o final de los archivos PHP, especialmente en wp-config.php o functions.php.

Causa

Archivos PHP con espacios en blanco antes de <?php o después de ?>.
Archivos con BOM (Byte Order Mark) en la codificación.

Solución

Abre el archivo problemático con un editor de texto como Notepad++ o VS Code.
Elimina cualquier espacio o línea en blanco antes de <?php y después de ?> (si existe).
Guarda el archivo con codificación UTF-8 sin BOM.
Sube el archivo nuevamente a Plesk.

9. Error de límite de memoria o tiempo de ejecución

Durante la migración, especialmente al importar bases de datos grandes, puedes encontrarte con errores como "Allowed memory size exhausted" o "Maximum execution time exceeded".

Solución

Aumenta los límites en Plesk: Ve a "Configuración de hosting" y ajusta los valores de memory_limit (por ejemplo, 512M) y max_execution_time (300 segundos).
Divide la importación: Si la base de datos es muy grande, usa phpMyAdmin y selecciona "Partial import" o divide el archivo SQL en partes más pequeñas.
Usa la línea de comandos (SSH) si tienes acceso: mysql -u usuario -p nombre_bd < archivo.sql es mucho más rápido.

10. No puedo acceder al panel de administración (wp-admin)

Después de la migración, a veces la URL de administración no funciona o redirige al dominio antiguo.

Solución

Accede directamente a http://nuevo-dominio.com/wp-login.php.
Si no funciona, restablece la URL desde la base de datos (como en el punto 4).
Desactiva plugins de seguridad (como Wordfence) que pueden bloquear el acceso debido al cambio de IP o dominio. Renombra la carpeta del plugin desde el Administrador de Archivos.

Conclusión: Checklist final para una migración exitosa

Migrar WordPress a Plesk no tiene por qué ser un dolor de cabeza. Si sigues esta FAQ paso a paso, resolverás el 90% de los problemas comunes. Aquí tienes un resumen rápido para verificar antes de dar por terminada la migración:

Base de datos: Credenciales correctas en wp-config.php.
Permisos: Carpetas 755, archivos 644.
URLs: Actualizadas en la base de datos y en el panel de administración.
SSL: Certificado instalado y redirección HTTPS activa.
PHP: Versión compatible y límites de memoria adecuados.
Plugins y temas: Desactivados temporalmente si hay errores.
Caché: Limpia la caché del navegador y cualquier plugin de caché.

[WARNING] Siempre haz una copia de seguridad completa (archivos + base de datos) antes de iniciar la migración. En Plesk, puedes usar la herramienta "Backup Manager" para esto.

Si después de todo sigues teniendo problemas, contacta con el soporte técnico de tu hosting. ¡Buena suerte con tu migración!