Solucionar problemas comunes de WordPress

Guía de solución de problemas comunes en WordPress. Aprende a diagnosticar y resolver errores frecuentes.

Pantalla blanca de la muerte

El sitio muestra solo una pantalla blanca:

Causas comunes

  • Error de PHP
  • Plugin o tema problemático
  • Memoria PHP insuficiente
  • Archivo corrupto

Solución

  • Accede por FTP
  • Renombra la carpeta de plugins: wp-content/plugins → wp-content/plugins-deactivated
  • Si funciona, reactiva plugins uno por uno
  • Si no funciona, renombra el tema activo
  • Revisa logs de error si es posible
  • Error de conexión a base de datos

    Mensaje: "Error establishing a database connection"

    Causas

    • Credenciales incorrectas en wp-config.php
    • Base de datos no existe o fue eliminada
    • Servidor de base de datos caído
    • Límite de conexiones excedido

    Solución

  • Verifica wp-config.php
  • Confirma credenciales en cPanel
  • Verifica que la base de datos existe
  • Contacta a soporte del hosting
  • No puedo acceder a wp-admin

    No puedes iniciar sesión:

    Soluciones

    • Limpia caché del navegador
    • Prueba modo incógnito
    • Usa "¿Olvidaste tu contraseña?"
    • Verifica que la URL sea correcta
    • Revisa si hay plugin bloqueando acceso
    • El sitio se ve roto

      El diseño no se ve correctamente:

      Causas

      • Tema desactualizado
      • Plugin conflictivo
      • CSS no cargando
      • Caché desactualizada

      Solución

    • Limpia caché (navegador y plugin)
    • Desactiva plugins recientes
    • Actualiza tema
    • Verifica que archivos del tema estén completos
    • No puedo subir archivos

      Error al subir imágenes o archivos:

      Causas

      • Límite de tamaño PHP excedido
      • Permisos de carpeta incorrectos
      • Espacio en disco lleno

      Solución

      • Aumenta upload_max_filesize en PHP
      • Verifica permisos de wp-content/uploads (755)
      • Verifica espacio disponible
      • Contacta a soporte para aumentar límites

      Plugins no se instalan

      Error al instalar plugins:

      Causas

      • Permisos de archivos incorrectos
      • Espacio en disco insuficiente
      • Límite de memoria PHP

      Solución

      • Verifica permisos de wp-content (755)
      • Verifica espacio disponible
      • Aumenta memory_limit en PHP
      • Instala manualmente por FTP
      • El sitio es muy lento

        Páginas cargan muy despacio:

        Soluciones

        • Instala plugin de caché
        • Optimiza imágenes
        • Elimina plugins no usados
        • Usa hosting más rápido
        • Optimiza base de datos
        • Usa CDN

        No puedo actualizar WordPress

        Error al actualizar:

        Soluciones

        • Verifica permisos de archivos
        • Aumenta memory_limit
        • Actualiza manualmente
        • Contacta a soporte

        Herramientas de diagnóstico

        • Health Check: Plugin oficial de WordPress para diagnosticar problemas
        • Error Logs: Revisa logs en cPanel
        • Debug Mode: Activa WP_DEBUG en wp-config.php

        Activar modo debug

        En wp-config.php, agrega:

        define('WP_DEBUG', true);
        define('WP_DEBUG_LOG', true);
        define('WP_DEBUG_DISPLAY', false);

        Los errores se guardarán en wp-content/debug.log

        Prevención de problemas

        • Haz backups regulares
        • Mantén WordPress, plugins y temas actualizados
        • No instales demasiados plugins
        • Prueba cambios en staging primero
        • Usa temas y plugins de fuentes confiables

        💡 Tip: Cuando tengas un problema, siempre haz backup antes de intentar solucionarlo. Así puedes restaurar si algo sale mal.