Errores comunes WordPress: soluciones para principiantes

¿Tu sitio web en WordPress de repente dejó de funcionar y no sabes qué hacer? No te preocupes, es más común de lo que crees. Como técnico de soporte, he visto cientos de casos de errores WordPress comunes que se solucionan con pasos sencillos. En esta guía básica, te enseñaré a identificar y solucionar errores WordPress sin necesidad de ser un experto en programación.

Vamos a empezar por lo fundamental: antes de hacer cualquier cambio, siempre haz una copia de seguridad de tu sitio. Esto te salvará de perder información si algo sale mal.

[WARNING] Nunca modifiques archivos importantes sin respaldo. Un simple error tipográfico puede dejar tu web inaccesible.

¿Por qué ocurren los errores en WordPress?

WordPress es un sistema muy flexible, pero suele fallar por tres razones principales:

Conflictos entre plugins o temas – Al instalar algo nuevo, puede chocar con lo que ya tienes.
Problemas de configuración del servidor – Límites de memoria, PHP desactualizado o errores en el archivo .htaccess.
Errores humanos – Como borrar archivos importantes por accidente o modificar código sin saber.

Conocer estas causas te ayudará a diagnosticar más rápido. Ahora veamos los problemas más frecuentes y cómo resolverlos paso a paso.

El temido "White Screen of Death" (Pantalla Blanca)

Este es uno de los problemas WordPress más aterradores: solo ves una página en blanco, sin mensajes de error. No entres en pánico. Generalmente es por un plugin o tema defectuoso.

Solución paso a paso

Accede a tu panel de control (como Syspanel en el puerto 2106) o mediante FTP.
Desactiva todos los plugins renombrando la carpeta /wp-content/plugins/ a /wp-content/plugins_old/. Esto obliga a WordPress a no cargarlos.
Si la web vuelve a funcionar, el problema es un plugin. Reactívalos de uno en uno renombrando la carpeta a su nombre original hasta encontrar el culpable.
Si no se soluciona, prueba cambiando el tema: renombra la carpeta del tema activo en /wp-content/themes/ (por ejemplo, de twentytwentyfour a twentytwentyfour_old). WordPress cargará un tema por defecto.

[TIP] Si no tienes acceso a FTP, muchos paneles de hosting (como Syspanel) tienen un "Administrador de archivos" donde puedes renombrar carpetas.

Aumentar la memoria PHP

A veces la pantalla blanca aparece porque WordPress se queda sin memoria. Edita el archivo wp-config.php (en la raíz de tu instalación) y agrega esta línea antes de /* That's all, stop editing! */:

define('WP_MEMORY_LIMIT', '256M');

Error 404 en todas las páginas (excepto la principal)

Si tu página de inicio funciona pero al hacer clic en cualquier enlace obtienes un WordPress 404 error, el problema suele ser la estructura de enlaces permanentes.

Cómo arreglarlo

Ve a Ajustes > Enlaces permanentes en tu escritorio de WordPress.
Sin cambiar nada, haz clic en Guardar cambios. Esto refresca las reglas de reescritura.
Si no funciona, es posible que el archivo .htaccess no tenga permisos de escritura. Debes crearlo o modificarlo manualmente.

Para crear el .htaccess desde cero, accede a tu servidor (por FTP o Syspanel) y en la carpeta raíz de WordPress, crea un archivo llamado .htaccess con este contenido:

# 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

[INFO] Si tu hosting usa Apache, asegúrate de que el módulo mod_rewrite esté activado. En Syspanel puedes verificarlo en la sección de "Servicios Web".

Error de conexión a la base de datos

Este error aparece cuando WordPress no puede comunicarse con la base de datos. Verás un mensaje como: "Error establishing a database connection".

Pasos para solucionarlo

Revisa el archivo wp-config.php – Busca las líneas que definen DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. Asegúrate de que coincidan con los datos de tu base de datos (puedes obtenerlos desde Syspanel en la sección "Bases de datos").
Prueba cambiar DB_HOST – A veces el valor correcto no es localhost, sino la dirección IP del servidor de bases de datos (como 127.0.0.1 o un socket).
Verifica que la base de datos exista – Desde Syspanel, entra al administrador de bases de datos (phpMyAdmin) y confirma que la base de datos y el usuario estén creados.
Reinicia los servicios – En tu panel de hosting, reinicia MySQL/MariaDB. En Syspanel, ve a "Servicios" y haz clic en "Reiniciar" junto a MySQL.

Si nada funciona, contacta a tu proveedor de hosting, ya que podría ser un problema del servidor.

Error "White Screen" al hacer login

A veces puedes ver la pantalla blanca solo al intentar acceder al escritorio. Esto suele deberse a un plugin de seguridad o a un tema conflictivo.

Solución rápida

Desactiva plugins desde la base de datos – Accede a phpMyAdmin (desde Syspanel), busca la tabla wp_options y localiza la fila active_plugins. Bórrala o cambia su valor a a:0:{}. Esto desactivará todos los plugins.
Limpia la caché del navegador – A veces el problema es local. Prueba en otro navegador o en modo incógnito.
Revisa el archivo .htaccess – Un error en este archivo puede bloquear el acceso al panel. Renómbralo temporalmente (por ejemplo, .htaccess_old) y prueba de nuevo.

Problemas con la actualización de WordPress

Al actualizar WordPress, plugins o temas, pueden aparecer errores como "Actualización fallida" o "Página no encontrada".

Cómo evitarlos y solucionarlos

Aumenta el tiempo de ejecución de PHP – En wp-config.php, agrega: set_time_limit(300);
Desactiva plugins antes de actualizar – Especialmente los de caché y seguridad.
Si la actualización se queda a medias – Descarga manualmente la última versión de WordPress desde wordpress.org, descomprime el archivo y sube la carpeta wp-admin y wp-includes por FTP, sobrescribiendo los archivos existentes (sin borrar wp-content ni wp-config.php).
Usa el modo de mantenimiento – Si ves el mensaje "Mantenimiento programado", borra el archivo .maintenance de la raíz de WordPress (si existe). Esto liberará el sitio.

Error "Headers already sent"

Este error aparece como una línea de texto al principio de la página, a menudo con mensajes como "Cannot modify header information". Ocurre cuando hay espacios en blanco o caracteres extra antes de la etiqueta <?php en un archivo.

Solución

Revisa wp-config.php – Asegúrate de que no haya espacios o líneas en blanco antes de <?php al inicio del archivo, ni después de ?> (si existe). Lo ideal es que no tenga la etiqueta de cierre ?>.
Revisa el archivo functions.php de tu tema – Abre el archivo y verifica que no haya caracteres ocultos al final.
Desactiva todos los plugins – Si el error desaparece, reactívalos uno por uno para encontrar el culpable.

[TIP] Usa un editor de código como Notepad++ o VS Code, que muestran caracteres invisibles. En Windows, evita el Bloc de notas porque puede agregar caracteres extra.

Errores de permisos de archivos

A veces WordPress no puede escribir en ciertas carpetas (para subir imágenes, instalar plugins, etc.). Verás mensajes como "No se pudo crear el directorio" o "Error al mover el archivo subido".

Cómo corregir los permisos

Accede a tu servidor por FTP o Syspanel y establece los siguientes permisos:

Carpetas: 755 (o 750 si tu hosting es más restrictivo)
Archivos: 644 (o 640)
Archivo wp-config.php: 600 (por seguridad)

En Syspanel, puedes hacerlo fácilmente: selecciona la carpeta /wp-content/ y elige "Cambiar permisos" en el menú contextual. Marca "Recursivo" para aplicar a todas las subcarpetas.

Problemas con la caché del navegador y del servidor

A veces ves cambios que no se reflejan, o la web se ve rota. Esto es por la caché.

Pasos para limpiar la caché

Limpia la caché de tu navegador (Ctrl+Shift+Supr en Chrome, por ejemplo).
Si usas un plugin de caché (como WP Super Cache o W3 Total Cache), ve a su configuración y haz clic en "Vaciar caché".
Caché del servidor – En Syspanel, busca la opción "Limpiar caché" en el panel de control (suele estar en la sección de "Rendimiento" o "Servicios").

Error "Maximum execution time exceeded"

Este error aparece cuando un script tarda demasiado en ejecutarse. Es común al instalar plugins pesados o al procesar muchas imágenes.

Solución

Aumenta el límite de tiempo – En wp-config.php, agrega: set_time_limit(300);
Si no funciona, edita el archivo php.ini (en Syspanel, busca "Configuración de PHP") y cambia max_execution_time a 300.
Desactiva plugins que consuman muchos recursos (como los de respaldo en tiempo real o los de galerías pesadas).

Preguntas frecuentes (FAQ)

¿Qué hago si no puedo acceder al escritorio de WordPress?

Si no puedes ni siquiera iniciar sesión, usa FTP o el administrador de archivos de Syspanel para desactivar plugins renombrando la carpeta plugins. También puedes cambiar el tema manualmente desde la base de datos (tabla wp_options, campo template y stylesheet).

¿Cómo puedo saber qué plugin está causando el error?

Desactiva todos los plugins y luego actívalos de uno en uno. Tras cada activación, prueba la funcionalidad que fallaba. Cuando el error vuelva a aparecer, ese es el plugin problemático.

¿Es seguro borrar el archivo .htaccess?

Sí, pero solo temporalmente. WordPress puede regenerarlo si vas a Ajustes > Enlaces permanentes y guardas de nuevo. Si lo borras, perderás las reglas de reescritura, así que mejor renómbralo.

¿Necesito conocimientos de programación para solucionar estos errores?

No. La mayoría de las soluciones son administrativas: renombrar carpetas, editar archivos con un editor de texto, o cambiar configuraciones desde el panel de control. Si sigues los pasos al pie de la letra, lo lograrás.

¿Debo contactar a mi hosting si el error persiste?

Sí, especialmente si se trata de errores de servidor (como la conexión a la base de datos o límites de recursos). Tu proveedor de hosting (especialmente si usas Syspanel) puede revisar los logs del servidor y ajustar configuraciones que tú no puedes modificar.

Consejos finales para evitar errores

Mantén todo actualizado – WordPress, plugins y temas. Las actualizaciones corrigen bugs de seguridad y rendimiento.
Usa un tema hijo – Si modificas el código de un tema, hazlo en un tema hijo para que las actualizaciones no borren tus cambios.
Instala un plugin de seguridad – Como Wordfence o Sucuri, que pueden bloquear ataques y notificarte de cambios sospechosos.
Haz copias de seguridad periódicas – Automatízalas con plugins como UpdraftPlus o desde el panel de Syspanel (muchos hosting ofrecen backups automáticos).
No instales plugins de fuentes dudosas – Siempre descarga desde el repositorio oficial de WordPress o de desarrolladores reconocidos.

Recuerda: la mayoría de los errores WordPress comunes tienen solución y no requieren ser un experto. Con paciencia y siguiendo esta guía, podrás solucionar errores WordPress tú mismo. Si te atascas, no dudes en pedir ayuda a tu hosting o a la comunidad de WordPress. ¡Buena suerte!