Solucionar errores comunes de WordPress en Plesk - Guía práctica

Errores comunes en WordPress con Plesk y cómo solucionarlos

Si estás usando Plesk para gestionar tu hosting y tienes un sitio en WordPress, es probable que en algún momento te encuentres con algún error. No te preocupes, es algo normal y casi siempre tiene solución. En esta guía vamos a ver los errores más frecuentes que aparecen al usar WordPress en Plesk, cómo identificarlos y, lo más importante, cómo solucionarlos paso a paso.

Entender estos problemas te ayudará a solucionar problemas WordPress de forma rápida, sin necesidad de ser un experto técnico. Vamos allá.

[INFO] Esta guía está pensada para usuarios de Plesk, pero muchos conceptos aplican también a otros paneles como Syspanel (antes HestiaCP, que usa el puerto 2106). Si usas Syspanel, los pasos son similares, solo cambia la interfaz.

Error 1: El famoso "Error de conexión a la base de datos"

Este es, sin duda, uno de los errores WordPress Plesk más comunes. Aparece cuando WordPress no puede comunicarse con la base de datos MySQL. La página se queda en blanco o muestra un mensaje como "Error establishing a database connection".

¿Por qué ocurre?

Los datos de conexión en el archivo wp-config.php son incorrectos.
La base de datos ha sido eliminada o está corrupta.
El usuario de la base de datos no tiene permisos.
El servidor MySQL está caído o sobrecargado.

Cómo solucionarlo

Verifica los datos en wp-config.php
Accede a tu sitio por FTP o al administrador de archivos de Plesk. Busca el archivo wp-config.php en la raíz de tu instalación de WordPress. Ábrelo y comprueba estas líneas:
```
define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');
```
Asegúrate de que coincidan exactamente con los datos de tu base de datos en Plesk. Un error común es poner localhost cuando el host es otro (a veces es 127.0.0.1 o un nombre de servidor).
Revisa la base de datos en Plesk
Ve a la sección "Bases de datos" en Plesk. Busca la base de datos de tu WordPress. Comprueba que el usuario exista y tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, edita el usuario y asígnale todos los permisos.
Prueba la conexión manualmente
Puedes usar la herramienta "phpMyAdmin" dentro de Plesk para acceder a la base de datos. Si puedes entrar, la base de datos funciona. Si no, el problema está en los datos de acceso.
Reinicia MySQL
Si todo parece correcto, puede que el servicio MySQL esté detenido. En Plesk, ve a "Herramientas y ajustes" > "Servicios" y busca "MySQL". Reinícialo.

[WARNING] Si cambias la contraseña de la base de datos desde Plesk, recuerda actualizarla también en el archivo wp-config.php. Si no, tu web dejará de funcionar hasta que lo hagas.

Error 2: Pantalla blanca de la muerte (WSOD)

La "White Screen of Death" es otro clásico entre los Plesk WordPress errores. La página se ve completamente en blanco, sin ningún mensaje de error.

¿Por qué ocurre?

Un plugin o tema incompatible.
Límite de memoria de PHP agotado.
Error de sintaxis en un archivo (por ejemplo, al editar funciones.php).

Cómo solucionarlo

Desactiva todos los plugins
Accede por FTP a la carpeta wp-content/plugins. Cambia el nombre de la carpeta a plugins_old. Esto forzará a WordPress a desactivar todos los plugins. Si la web vuelve a funcionar, el problema está en uno de ellos. Luego, ve renombrando carpetas una por una para identificar al culpable.
Cambia al tema por defecto
Ve a wp-content/themes y renombra la carpeta de tu tema actual (por ejemplo, a mi-tema-old). WordPress usará automáticamente el tema por defecto (Twenty Twenty-Four o similar). Si la web se recupera, el problema es del tema.
Aumenta el límite de memoria de PHP
En Plesk, ve a "Configuración de PHP" para tu dominio. Busca la opción memory_limit y cámbiala a 256M o 512M. Guarda los cambios.
Activa el modo debug
Edita el archivo wp-config.php y añade esta línea justo antes de la línea que dice "Eso es todo, ¡deja de editar!":
```
define('WP_DEBUG', true);
```
Luego, recarga la web. Aparecerán errores específicos que te indicarán el archivo problemático.

[TIP] Si no puedes acceder a tu web ni al panel de administración, usa FTP o el administrador de archivos de Plesk para hacer estos cambios.

Error 3: Problemas con los enlaces permanentes (404 en páginas internas)

Después de migrar tu WordPress o cambiar la estructura de enlaces, puede que todas las páginas internas (excepto la portada) den error 404. Esto suele pasar cuando los enlaces permanentes no se regeneran correctamente.

¿Por qué ocurre?

El archivo .htaccess no se ha actualizado.
El módulo mod_rewrite de Apache no está activo.
Plesk no tiene configurado correctamente el soporte para enlaces amigables.

Cómo solucionarlo

Regenera los enlaces permanentes
Entra al panel de administración de WordPress (si puedes). Ve a "Ajustes" > "Enlaces permanentes". Simplemente selecciona una opción (por ejemplo, "Nombre de la entrada") y haz clic en "Guardar cambios". Esto regenera el archivo .htaccess.

Revisa el archivo .htaccess
Si no puedes acceder al panel, ve por FTP a la raíz de tu WordPress y busca el archivo .htaccess. Si no existe, créalo con 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

Activa mod_rewrite en Plesk
Ve a "Configuración de Apache" para tu dominio. Asegúrate de que la opción "mod_rewrite" esté habilitada. En versiones recientes de Plesk, esto suele estar activado por defecto.

[INFO] Si usas Nginx en lugar de Apache, el proceso es diferente. En Plesk, ve a "Configuración de Nginx" y activa "Proxy mode" o "WordPress optimization". Esto suele resolver el problema automáticamente.

Error 4: No se pueden instalar plugins o temas (pide credenciales FTP)

Este error aparece cuando intentas instalar un plugin o tema desde el panel de WordPress y te pide usuario y contraseña de FTP. Es frustrante, pero fácil de arreglar.

¿Por qué ocurre?

Los permisos de archivos no son correctos.
El servidor web no tiene permisos de escritura en las carpetas wp-content.

Cómo solucionarlo

Añade las credenciales FTP directamente en wp-config.php
Abre el archivo wp-config.php y añade estas líneas:
```
define('FS_METHOD', 'direct');
```
Esto le dice a WordPress que use el sistema de archivos directamente, sin pedir FTP.
Corrige los permisos de archivos en Plesk
Ve a "Administrador de archivos" en Plesk. Selecciona la carpeta wp-content. Haz clic en "Permisos" y asegúrate de que el usuario del servidor web (normalmente www-data o apache) tenga permisos de lectura y escritura. Un valor seguro es 755 para carpetas y 644 para archivos.
Cambia el propietario de los archivos
En Plesk, ve a "Configuración de hosting" para tu dominio. Busca la opción "Propietario del sitio" o "Usuario del sistema". Asegúrate de que coincida con el usuario que ejecuta PHP. Si no, cambia el propietario de toda la carpeta de WordPress usando el comando chown desde SSH (si tienes acceso).

[WARNING] No pongas permisos 777 en ninguna carpeta. Es un riesgo de seguridad grave. Usa siempre 755 para carpetas y 644 para archivos.

Error 5: El administrador de archivos de Plesk no muestra los cambios

A veces, después de subir archivos por FTP o modificar algo desde el administrador de archivos de Plesk, los cambios no se ven en la web. Esto suele deberse a la caché.

¿Por qué ocurre?

Caché del navegador.
Caché de WordPress (plugins de caché).
Caché de servidor (Varnish, Nginx, etc.).

Cómo solucionarlo

Limpia la caché del navegador
Prueba a cargar la página en modo incógnito o con Ctrl+F5 (Windows) / Cmd+Shift+R (Mac).
Limpia la caché de WordPress
Si usas un plugin de caché (como WP Super Cache o W3 Total Cache), ve a su configuración y pulsa "Vaciar caché".
Limpia la caché de Plesk
En Plesk, ve a "Herramientas y ajustes" > "Caché" y selecciona "Limpiar toda la caché". También puedes reiniciar el servicio de Nginx o Apache desde la sección "Servicios".

[TIP] Si usas Syspanel (antes HestiaCP, puerto 2106), la caché se gestiona desde la pestaña "Caché" del panel. Es un proceso similar.

Error 6: El certificado SSL no funciona correctamente

Al activar SSL en Plesk para tu WordPress, a veces la web se ve con errores de contenido mixto (imágenes o scripts cargados sobre HTTP en lugar de HTTPS).

¿Por qué ocurre?

La URL del sitio en WordPress sigue siendo HTTP.
Algunos plugins o temas tienen enlaces absolutos con HTTP.

Cómo solucionarlo

Cambia la URL del sitio en WordPress
Ve a "Ajustes" > "Generales" en el panel de administración. Cambia las dos URLs (Dirección de WordPress y Dirección del sitio) de http:// a https://. Guarda los cambios.
Usa un plugin para corregir contenido mixto
Instala un plugin como "Really Simple SSL". Este plugin detecta y corrige automáticamente la mayoría de los problemas de contenido mixto.
Forza HTTPS desde Plesk
Ve a "Configuración de hosting" para tu dominio. Activa la opción "Redirigir HTTP a HTTPS". Esto hará que todas las visitas sean forzadas a usar HTTPS.

[INFO] Después de activar SSL, es posible que tengas que volver a regenerar los enlaces permanentes (como vimos en el Error 3) para evitar problemas de redirección.

Preguntas Frecuentes (FAQ)

¿Cómo puedo evitar estos errores en el futuro?

Mantén WordPress, plugins y temas actualizados. Haz copias de seguridad periódicas desde Plesk (usa la herramienta "Copias de seguridad"). Revisa los logs de errores en Plesk (sección "Registros") para detectar problemas antes de que afecten a los visitantes.

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

Usa FTP o el administrador de archivos de Plesk para desactivar plugins (renombrando la carpeta plugins) o cambiar el tema (renombrando la carpeta del tema en wp-content/themes). También puedes usar la herramienta "phpMyAdmin" para cambiar directamente en la base de datos la opción del tema activo.

¿Plesk tiene alguna herramienta específica para WordPress?

Sí, Plesk incluye un "Asistente de WordPress" que permite instalar, clonar, hacer copias de seguridad y solucionar problemas comunes desde su interfaz. Búscalo en la sección "Aplicaciones" o "WordPress" de tu panel.

¿Estos errores también ocurren en Syspanel (antes HestiaCP)?

Sí, los errores son similares. La diferencia principal es la interfaz. En Syspanel, accedes por el puerto 2106 y las opciones de configuración están en secciones como "Bases de datos", "Archivos" y "Servicios". Los pasos para solucionarlos son prácticamente los mismos.

¿Qué hago si el error persiste después de seguir todos los pasos?

Revisa los logs de error de WordPress (activando WP_DEBUG como explicamos) y los logs del servidor en Plesk (sección "Registros"). Si el error es complejo, puede ser necesario contactar al soporte técnico de tu hosting, proporcionándoles los mensajes de error exactos.

Esperamos que esta guía te haya sido útil para entender y solucionar problemas WordPress relacionados con errores WordPress Plesk. Recuerda que la paciencia y la revisión paso a paso son tus mejores aliadas. Si tienes dudas, vuelve a leer la sección correspondiente o consulta nuestra base de conocimientos. ¡Buena suerte con tu sitio!