Errores comunes al instalar WordPress en Plesk y cómo arreglarlos

¡Hola! Soy tu técnico de soporte amigable. Entiendo que instalar WordPress en Plesk puede ser un dolor de cabeza cuando aparecen errores inesperados. No te preocupes, estoy aquí para guiarte paso a paso y resolver los problemas más comunes. Vamos a desglosar cada error y su solución de manera sencilla, para que tu sitio web esté funcionando en un abrir y cerrar de ojos.

Errores Comunes al Instalar WordPress en Plesk y Cómo Solucionarlos

Cuando intentas instalar WordPress en Plesk, pueden surgir varios problemas. Aquí te explico los más frecuentes y cómo resolverlos. Recuerda que la paciencia es clave y que siempre puedes contactar a tu proveedor de hosting si algo se complica.

1. Error de Conexión a la Base de Datos

Este es uno de los errores más típicos. Aparece un mensaje como "Error establishing a database connection" o "No se puede conectar a la base de datos". Generalmente, esto se debe a credenciales incorrectas o a que la base de datos no se ha creado correctamente.

¿Por qué ocurre?

Los datos de la base de datos (nombre, usuario, contraseña) no coinciden con los que ingresaste en el archivo wp-config.php.
El servidor de base de datos (MySQL/MariaDB) no está funcionando.
El usuario de la base de datos no tiene permisos para acceder a ella.

Pasos para solucionarlo:

Verifica las credenciales en Plesk: Accede a tu panel de Plesk. Ve a "Bases de datos" (o "Databases" en inglés). Busca la base de datos que creaste para WordPress. Anota el nombre exacto, el usuario y la contraseña. Asegúrate de que no haya espacios ni errores tipográficos.
Revisa el archivo wp-config.php: Descarga el archivo wp-config.php de tu instalación de WordPress (por FTP o desde el administrador de archivos de Plesk). Ábrelo con un editor de texto (como Bloc de notas o Sublime Text). Busca estas líneas:
```
define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');
```
Compara los valores con los que anotaste en el paso anterior. Corrige cualquier error.
Verifica el servidor de base de datos: En Plesk, ve a "Herramientas y configuraciones" > "Servicios". Busca "MySQL" o "MariaDB" y asegúrate de que esté en estado "En ejecución" (Running). Si está detenido, haz clic en "Iniciar".
Prueba la conexión manualmente: Si tienes acceso a phpMyAdmin desde Plesk, puedes probar la conexión. Ve a "Bases de datos" > "phpMyAdmin". Inicia sesión con el usuario y contraseña de la base de datos. Si puedes acceder, el problema está en el archivo wp-config.php. Si no, verifica los permisos del usuario.

[TIP] Si usas Syspanel (HestiaCP), el acceso a la base de datos se hace por el puerto 2106. Ve a "Bases de datos" y crea una nueva, anotando bien los datos. Luego, en tu archivo wp-config.php, asegúrate de que el DB_HOST sea localhost o la IP del servidor.

2. Error "Headers Already Sent" o "No se puede modificar la información del encabezado"

Este error suele aparecer como un mensaje en blanco o con texto como "Warning: Cannot modify header information – headers already sent by...". Es un problema común relacionado con espacios en blanco o caracteres extra en los archivos de WordPress.

¿Por qué ocurre?

Hay espacios, saltos de línea o caracteres invisibles (como BOM) al principio o al final de los archivos wp-config.php o functions.php.
Se ha modificado el archivo wp-config.php con un editor que añade caracteres ocultos.

Pasos para solucionarlo:

Abre el archivo wp-config.php con un editor de texto limpio: Usa un editor como Notepad++, Sublime Text o el editor de archivos de Plesk (que suele ser fiable). Evita editores como WordPad o Microsoft Word, que pueden añadir formato oculto.
Revisa el inicio y el final del archivo: Al principio del archivo, no debe haber ningún carácter antes de la etiqueta <?php. Al final del archivo, no debe haber ningún carácter después de la etiqueta ?> (si existe). De hecho, en WordPress moderno, se recomienda no cerrar la etiqueta PHP al final del archivo. Si ves ?>, bórrala.
Busca espacios en blanco: Con el editor, asegúrate de que no haya líneas vacías antes de <?php ni después del último código PHP.
Guarda el archivo con codificación UTF-8 sin BOM: La mayoría de los editores permiten elegir la codificación. Selecciona "UTF-8 without BOM" (UTF-8 sin BOM). Esto elimina caracteres ocultos.
Revisa el archivo functions.php del tema: Si el error persiste, puede venir del tema que estás usando. Ve a "Apariencia" > "Editor de temas" en WordPress (si puedes acceder) o descarga el archivo functions.php por FTP. Repite el mismo proceso de revisión.

[WARNING] Nunca edites archivos PHP con editores de texto que no sean de código puro. Un simple espacio invisible puede romper todo tu sitio. Si no estás seguro, usa siempre el editor de archivos de Plesk.

3. Error de Permisos de Archivos y Carpetas

Este error se manifiesta como "No se puede escribir en el directorio wp-content", "Error al subir archivos", o simplemente el sitio se ve sin estilos (CSS) o imágenes. Los permisos incorrectos impiden que WordPress funcione correctamente.

¿Por qué ocurre?

Los archivos o carpetas tienen permisos demasiado restrictivos (por ejemplo, 644 en lugar de 755 para carpetas).
El usuario del servidor web (www-data, nginx, etc.) no es el propietario de los archivos.

Pasos para solucionarlo:

Accede al administrador de archivos de Plesk: Ve a "Archivos" o "File Manager" en tu dominio.
Navega a la carpeta raíz de WordPress: Normalmente es httpdocs o public_html.
Corrige los permisos de las carpetas: Selecciona todas las carpetas (wp-admin, wp-content, wp-includes, etc.) y cambia los permisos a 755 (rwxr-xr-x). En Plesk, puedes hacerlo seleccionando las carpetas y usando la opción "Cambiar permisos".
Corrige los permisos de los archivos: Selecciona todos los archivos (excepto wp-config.php) y cambia los permisos a 644 (rw-r--r--). El archivo wp-config.php puede ser 600 (rw-------) para mayor seguridad.
Verifica la propiedad (ownership): En la misma interfaz de archivos, busca la opción "Propietario" o "Owner". Asegúrate de que todos los archivos y carpetas pertenezcan al usuario del plan de hosting (normalmente el mismo que tu usuario de Plesk) y al grupo correspondiente (por ejemplo, psacln). Si no es así, cambia la propiedad.
Revisa la carpeta wp-content/uploads: Esta carpeta debe tener permisos 755 y ser propiedad del usuario del servidor web. Si tienes problemas para subir imágenes, cámbiala a 777 temporalmente (solo para pruebas) y luego vuelve a 755.

[INFO] En Syspanel (HestiaCP), los permisos se gestionan desde el administrador de archivos o por línea de comandos. La estructura es similar: public_html es la raíz. Asegúrate de que el usuario admin (o el que creaste) sea el propietario.

4. Error de Versión de PHP o Extensiones Faltantes

WordPress requiere una versión específica de PHP y ciertas extensiones para funcionar. Si tu servidor tiene una versión antigua o faltan módulos, verás errores como "Tu servidor utiliza PHP versión X.X, pero WordPress recomienda PHP 7.4 o superior" o "No se encuentra la extensión mysqli".

¿Por qué ocurre?

La versión de PHP asignada a tu dominio es inferior a la requerida (WordPress 6.x necesita PHP 7.4+).
Faltan extensiones como mysqli, curl, gd, mbstring, xml, etc.

Pasos para solucionarlo:

Cambia la versión de PHP en Plesk: Ve a "Herramientas y configuraciones" > "Configuración de PHP" (o "PHP Settings"). Selecciona tu dominio y elige una versión de PHP moderna, como 8.0, 8.1 o 8.2. Aplica los cambios.
Verifica las extensiones habilitadas: En la misma página de "Configuración de PHP", busca la sección "Extensiones" o "Extensions". Asegúrate de que estén habilitadas las siguientes: mysqli, curl, gd, mbstring, xml, zip, intl. Si alguna está deshabilitada, actívala.
Prueba con un archivo de información PHP: Crea un archivo llamado info.php en la raíz de tu dominio con el siguiente contenido:
```
<?php phpinfo(); ?>
```
Accede a http://tudominio.com/info.php. Busca "PHP Version" y "Loaded Configuration File". También revisa la sección "mysqli", "curl", etc. Si ves que están presentes, el problema no es de extensiones.
Elimina el archivo info.php después de la prueba: Por seguridad, bórralo una vez que hayas verificado.

[WARNING] No dejes el archivo info.php accesible públicamente, ya que revela información sensible de tu servidor. Bórralo inmediatamente después de usarlo.

5. Error de Memoria Límite (Allowed Memory Size Exhausted)

Si ves un error como "Allowed memory size of 268435456 bytes exhausted (tried to allocate...)", significa que WordPress necesita más memoria de la que tiene asignada.

¿Por qué ocurre?

El límite de memoria de PHP es demasiado bajo (por defecto suele ser 128M o 256M).
Un plugin o tema consume mucha memoria.

Pasos para solucionarlo:

Aumenta el límite de memoria en wp-config.php: Añade esta línea justo antes del comentario "That's all, stop editing! Happy blogging":
```
define('WP_MEMORY_LIMIT', '512M');
```
Esto asigna 512 MB de memoria. Puedes probar con 256M si 512 parece excesivo.
Aumenta el límite de memoria en PHP (desde Plesk): Ve a "Configuración de PHP" de tu dominio. Busca la opción memory_limit y cámbiala a 512M o 1024M. Aplica los cambios.
Desactiva plugins y temas sospechosos: Si el error persiste, desactiva todos los plugins cambiando el nombre de la carpeta wp-content/plugins a wp-content/plugins_backup (desde el administrador de archivos). Luego, ve a tu sitio y actívalos uno por uno para identificar el culpable.
Verifica el límite máximo permitido por tu hosting: Algunos proveedores tienen un límite máximo. Si necesitas más, contacta a soporte.

[TIP] Si usas Syspanel, el límite de memoria se configura desde "Configuración de PHP" en el panel. Busca la opción memory_limit y ajústala.

6. Error de Redireccionamiento o Bucle de Redirección

Este error hace que el navegador muestre "ERR_TOO_MANY_REDIRECTS" o "Esta página no funciona". Es común después de cambiar la URL del sitio o al configurar SSL.

¿Por qué ocurre?

Configuración incorrecta de las URLs en wp-config.php o en la base de datos.
Problemas con el certificado SSL (redirección forzada a HTTPS).
Reglas de redirección en el archivo .htaccess.

Pasos para solucionarlo:

Verifica las URLs en wp-config.php: Añade estas líneas a tu wp-config.php (justo después de las definiciones de la base de datos):
```
define('WP_HOME', 'http://tudominio.com');
define('WP_SITEURL', 'http://tudominio.com');
```
Si tienes SSL, usa https:// en lugar de http://. Asegúrate de que no haya barras al final.
Revisa el archivo .htaccess: Descarga el archivo .htaccess de la raíz de tu dominio. Si está corrupto o tiene reglas incorrectas, renómbralo a .htaccess_backup. Luego, ve a "Ajustes" > "Enlaces permanentes" en WordPress y haz clic en "Guardar cambios" para generar uno nuevo.
Desactiva la redirección forzada a HTTPS temporalmente: En Plesk, ve a "Configuración del sitio" o "Hosting Settings". Desmarca la opción "Redirigir automáticamente a HTTPS" (si existe). Prueba tu sitio. Si funciona, el problema está en la configuración SSL.
Limpia la caché del navegador: A veces el navegador guarda redirecciones antiguas. Borra la caché o usa una ventana de incógnito.

[WARNING] No modifiques el archivo .htaccess si no sabes lo que haces. Un error puede dejar tu sitio inaccesible. Siempre haz una copia de seguridad antes.

7. Error de Instalación Incompleta o "No se puede conectar al servidor FTP"

Al instalar WordPress desde el panel de Plesk (con el instalador automático), a veces el proceso se queda a medias o pide credenciales FTP. Esto suele ser un problema de permisos del instalador.

¿Por qué ocurre?

El instalador de WordPress de Plesk no tiene permisos para escribir en el directorio.
El método de instalación directa de WordPress requiere acceso FTP, pero Plesk no lo proporciona automáticamente.

Pasos para solucionarlo:

Usa el instalador de WordPress de Plesk correctamente: Ve a "Aplicaciones" o "WordPress" en Plesk. Selecciona "Instalar". Asegúrate de que el directorio de instalación sea la raíz (por ejemplo, / o httpdocs). No lo instales en una subcarpeta a menos que quieras.
Si pide FTP, ignóralo y usa el método manual: El instalador de Plesk a veces falla. Es más fiable instalar WordPress manualmente. Descarga WordPress desde wordpress.org, súbelo por FTP al directorio raíz, crea la base de datos desde Plesk y luego ejecuta el script de instalación (http://tudominio.com/wp-admin/install.php).
Verifica los permisos del directorio raíz: Asegúrate de que el directorio raíz (httpdocs o public_html) tenga permisos 755 y sea propiedad del usuario de Plesk.
Reintenta la instalación después de limpiar: Si el instalador automático dejó archivos a medias, elimina todo el contenido de la carpeta raíz (haz una copia de seguridad primero) y vuelve a intentarlo.

[INFO] En Syspanel, el instalador de aplicaciones se encuentra en "Aplicaciones Web". Si falla, siempre puedes instalar WordPress manualmente. Es un proceso sencillo y te da más control.

8. Error de Tiempo de Espera (Timeout) al Instalar

Si la instalación se queda cargando y termina en un error de tiempo de espera, puede deberse a un servidor lento o a una configuración de PHP restrictiva.

¿Por qué ocurre?

El límite de tiempo de ejecución de PHP (max_execution_time) es demasiado bajo.
El servidor tiene poca potencia o muchos sitios activos.

Pasos para solucionarlo:

Aumenta el tiempo de ejecución en PHP: En