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

Introducción: ¿Por qué falla la instalación de WordPress en Plesk?

Instalar WordPress en Plesk suele ser un proceso sencillo, pero a veces aparecen errores que pueden frustrar incluso al usuario más paciente. Si estás aquí, probablemente te has encontrado con algún problema al intentar desplegar tu sitio web. No te preocupes, es más común de lo que crees. En esta guía, vamos a repasar los errores WordPress Plesk más frecuentes, por qué ocurren y cómo solucionarlos paso a paso. Piensa en esto como tu mapa para resolver cualquier tropiezo técnico.

[INFO] Este artículo está pensado para usuarios sin experiencia técnica. Si no entiendes algún término, solo busca en la sección correspondiente; la explicación es muy básica.

Error #1: "No se puede conectar a la base de datos"

Este es, sin duda, el error más común al instalar WordPress Plesk falla. Aparece cuando WordPress no logra comunicarse con la base de datos MySQL o MariaDB que creaste en Plesk. Las causas suelen ser simples: credenciales incorrectas o permisos mal configurados.

¿Cómo solucionarlo?

Verifica las credenciales en el archivo wp-config.php: Accede a tu cuenta de Plesk, ve a "Archivos" y busca el archivo wp-config.php en la raíz de tu sitio. Ábrelo con el editor de texto de Plesk.
Revisa estos valores:
- DB_NAME: El nombre exacto de la base de datos (suele ser algo como usuario_wp).
- DB_USER: El usuario de la base de datos (normalmente el mismo que el nombre de la base de datos).
- DB_PASSWORD: La contraseña que asignaste. No uses caracteres especiales como &, %, # porque pueden romper la conexión.
Prueba la conexión manualmente: En Plesk, ve a "Bases de datos", selecciona tu base y usa la herramienta "phpMyAdmin". Si puedes entrar, el problema está en el archivo. Si no, la contraseña o el usuario están mal.

[TIP] Si usas "Syspanel" (el panel de control que antes se llamaba HestiaCP, accesible por el puerto 2106), el proceso es similar: busca el archivo wp-config.php en la carpeta de tu dominio.

Error #2: "Error al establecer conexión con la base de datos" (durante la instalación)

Este error suele aparecer justo en el paso 2 del asistente de WordPress, cuando introduces los datos de la base de datos. La causa más frecuente es que el servidor de base de datos no está accesible o el nombre del host es incorrecto.

Pasos para resolverlo:

Confirma el host de la base de datos: En Plesk, el host suele ser localhost. Pero si tu plan de hosting usa servidores separados, puede ser una IP como 127.0.0.1 o un nombre tipo mysql.tudominio.com. Revisa en Plesk > "Bases de datos" > tu base > "Detalles".
Comprueba los puertos: Por defecto, MySQL usa el puerto 3306. Si tu proveedor lo ha cambiado, debes añadirlo al host (ejemplo: localhost:3307).
Reinicia el servicio MySQL: Si tienes acceso SSH o a través de Plesk (en "Herramientas y ajustes" > "Servicios"), reinicia MySQL. A veces solo necesita un refresco.

[WARNING] No uses localhost si tu base de datos está en otro servidor. Pregunta a tu proveedor de hosting cuál es el host correcto.

Error #3: "No se puede conectar al servidor FTP" (al instalar plugins o temas)

Este error es típico cuando intentas instalar plugins o temas desde el panel de WordPress, pero Plesk no tiene configuradas las credenciales FTP correctas. En realidad, la mayoría de las veces no necesitas FTP si usas Plesk.

Solución rápida:

Edita el archivo wp-config.php: Añade estas líneas justo antes de la línea que dice /* That's all, stop editing! */:
```
define('FS_METHOD', 'direct');
```
Esto le dice a WordPress que use el sistema de archivos directamente, sin FTP.
Guarda el archivo y vuelve a intentarlo. Si el error persiste, es posible que los permisos de las carpetas no sean correctos.

[INFO] Si usas "Syspanel" (puerto 2106), el método es idéntico. Solo busca el archivo wp-config.php en la carpeta del dominio.

Error #4: "La página se queda en blanco" (Pantalla Blanca de la Muerte)

Una pantalla completamente blanca al acceder a tu sitio suele deberse a un error de PHP no mostrado. Puede ser por un plugin conflictivo, un tema mal codificado o un límite de memoria alcanzado.

Pasos para diagnosticar:

Activa el modo de depuración de WordPress: En wp-config.php, busca la línea define('WP_DEBUG', false); y cámbiala a:
```
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
```
Esto creará un archivo debug.log en la carpeta wp-content. Revísalo para ver el error exacto.
Desactiva plugins manualmente: Si no puedes acceder al panel, renombra la carpeta wp-content/plugins a plugins_old mediante el administrador de archivos de Plesk. Esto desactivará todos los plugins.
Aumenta la memoria de PHP: En Plesk, ve a "Configuración de PHP" (dentro de tu dominio) y sube el valor de memory_limit a 256M o 512M.

[TIP] Si el error persiste, prueba a cambiar el tema por defecto (Twenty Twenty-Four) renombrando la carpeta wp-content/themes/tu-tema a tu-tema_old.

Error #5: "Permisos de archivo incorrectos" (error 403 o 500)

Los errores 403 (prohibido) o 500 (error interno del servidor) suelen deberse a permisos de archivos o carpetas mal configurados. En Plesk, esto es fácil de arreglar.

Cómo ajustar permisos:

Ve a "Archivos" en Plesk y selecciona la carpeta raíz de tu sitio.
Selecciona todos los archivos (Ctrl+A) y haz clic en "Permisos".
Aplica estos valores:
- Carpetas: 755 (o 750 si tu hosting es más restrictivo).
- Archivos: 644 (o 640).
No olvides el archivo wp-config.php: Debe tener permisos 600 o 640 para mayor seguridad.

[WARNING] Nunca pongas permisos 777. Es un riesgo de seguridad enorme. Si necesitas escribir archivos, usa 755 para carpetas y 644 para archivos.

Error #6: "El instalador de WordPress no se carga" (página en blanco al acceder a /wp-admin/install.php)

Este error ocurre cuando el archivo wp-config.php ya existe (porque lo creaste manualmente) o cuando hay un problema con la base de datos. También puede ser por un límite de tiempo de ejecución de PHP muy bajo.

Soluciones:

Elimina el archivo wp-config.php existente: Si ya lo habías creado manualmente, bórralo desde el administrador de archivos de Plesk. Luego vuelve a intentar la instalación.
Aumenta el tiempo de ejecución de PHP: En la configuración de PHP de tu dominio, cambia max_execution_time a 300 segundos.
Verifica que la base de datos esté vacía: Si ya habías intentado instalar WordPress antes, la base puede tener tablas viejas. Usa phpMyAdmin para borrarlas o crea una base de datos nueva.

Error #7: "Error de SSL: El certificado no es válido" (al acceder con HTTPS)

Si intentas acceder a tu sitio con HTTPS y ves un error de certificado, es porque Plesk no ha configurado correctamente el SSL o el certificado no es válido para tu dominio.

Cómo solucionarlo:

Activa SSL en Plesk: Ve a "Alojamiento web" > tu dominio > "Certificados SSL/TLS".
Instala un certificado gratuito de Let's Encrypt: Plesk tiene un asistente. Solo haz clic en "Obtener un certificado gratuito" y sigue los pasos.
Forza HTTPS: En la misma sección, marca "Redirigir HTTP a HTTPS". Esto evitará errores mixtos.
Actualiza la URL de WordPress: Si ya instalaste WordPress, ve a Ajustes > Generales y cambia "Dirección de WordPress" y "Dirección del sitio" a https://tudominio.com.

[INFO] Si usas "Syspanel" (puerto 2106), el proceso es similar, pero la opción puede estar en "SSL" dentro de la configuración del dominio.

Error #8: "No se puede conectar a la API de WordPress" (al actualizar)

Este error suele deberse a que tu servidor no puede conectarse a los servidores de WordPress (api.wordpress.org) por restricciones de firewall o DNS.

Pasos para resolverlo:

Verifica la conectividad DNS: En Plesk, ve a "Herramientas y ajustes" > "Configuración de red" y asegúrate de que los servidores DNS de tu servidor funcionan (8.8.8.8 es una opción segura).
Desactiva temporalmente el firewall: Si tienes un firewall como CSF, prueba a desactivarlo por un momento para ver si ese es el problema.
Añade la IP de WordPress a la lista blanca: Si tu proveedor bloquea ciertas IPs, pídele que permita las IPs de api.wordpress.org (puedes encontrarlas en su web).

Error #9: "El archivo .htaccess no funciona" (enlaces permanentes rotos)

Después de cambiar los enlaces permanentes (por ejemplo, a "Nombre de entrada"), tus páginas dan error 404. Esto pasa porque Plesk no ha permitido que WordPress modifique el archivo .htaccess.

Solución:

Edita el archivo .htaccess: En la raíz de tu sitio, ábrelo con el editor de Plesk.

Añade estas reglas (si no están):

# 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

Guarda y vuelve a guardar los enlaces permanentes en WordPress (Ajustes > Enlaces permanentes > Guardar cambios).

[TIP] Si el archivo .htaccess no existe, créalo desde el administrador de archivos de Plesk con permisos 644.

Error #10: "El plugin no se puede instalar porque el directorio wp-content no tiene permisos de escritura"

Este error es muy común en servidores compartidos con Plesk. WordPress necesita poder escribir en las carpetas wp-content, wp-content/plugins y wp-content/themes.

Cómo arreglarlo:

Cambia el propietario de la carpeta: En Plesk, ve a "Archivos", selecciona la carpeta wp-content y haz clic en "Permisos". Asegúrate de que el usuario del dominio (normalmente el mismo que tu nombre de usuario de Plesk) sea el propietario.
Aplica permisos 755 a toda la carpeta wp-content y sus subcarpetas.
Si aún falla, añade la línea define('FS_METHOD', 'direct'); en wp-config.php (como vimos en el error #3).

Preguntas Frecuentes Adicionales (FAQ)

¿Puedo instalar WordPress manualmente en Plesk?

Sí, puedes descargar WordPress desde wordpress.org, subir los archivos vía FTP o el administrador de archivos de Plesk, crear una base de datos y ejecutar el instalador. Es más tedioso, pero te da más control.

¿Qué hago si no veo el botón "Instalar WordPress" en Plesk?

Algunos planes de hosting no incluyen el instalador automático. En ese caso, usa el método manual o contacta a tu proveedor para que lo active. También puedes usar "Syspanel" (puerto 2106) si tu proveedor lo ofrece.

¿Por qué mi sitio se ve lento después de instalar WordPress?

Puede ser por un tema pesado, muchos plugins, o que tu servidor no tenga suficientes recursos. Prueba a desactivar plugins uno por uno y usa un tema ligero como GeneratePress o Astra.

¿Cómo hago una copia de seguridad antes de instalar?

En Plesk, ve a "Herramientas y ajustes" > "Copias de seguridad" y crea una del dominio. También puedes usar plugins como UpdraftPlus en WordPress.

[WARNING] Siempre haz una copia de seguridad antes de hacer cambios importantes, como instalar WordPress o modificar archivos críticos.

Conclusión: No temas a los errores, son parte del aprendizaje

Los errores WordPress Plesk son más comunes de lo que piensas, pero con esta guía tienes las herramientas para resolverlos. Recuerda que la paciencia es clave: cada error te enseña algo nuevo sobre cómo funciona tu sitio. Si después de probar todo sigues teniendo problemas, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen acceso a los logs del servidor y pueden ayudarte a identificar problemas más profundos.

[INFO] Para usuarios de "Syspanel" (panel de control con acceso por puerto 2106), los pasos son prácticamente idénticos, solo cambian los nombres de algunas opciones. Si tienes dudas, busca en la documentación de tu proveedor.

¡Esperamos que este artículo te haya sido útil! Ahora ya sabes cómo enfrentar los Plesk WordPress problemas comunes y convertirte en un experto en WordPress Plesk troubleshooting.