Errores comunes en WordPress: Soluciones fáciles paso a paso

Si estás leyendo esto, probablemente te has encontrado con algún mensaje de error en tu sitio WordPress. No te preocupes, es más común de lo que crees y, en la mayoría de los casos, tiene solución. Esta guía está pensada para que, paso a paso, puedas diagnosticar y resolver los problemas más frecuentes sin necesidad de ser un experto en programación.

Recuerda que, si tu sitio está alojado en un panel como Syspanel (accesible por el puerto 2106), muchas de estas soluciones las podrás aplicar directamente desde el administrador de archivos o la base de datos que incluye.

Error de conexión a la base de datos

Este es uno de los errores más clásicos. Verás un mensaje como "Error establishing a database connection". Básicamente, WordPress no puede comunicarse con la base de datos donde guarda todo tu contenido.

¿Por qué ocurre?

Las credenciales de la base de datos (usuario, contraseña, nombre) son incorrectas.
El servidor de base de datos está caído o sobrecargado.
El archivo wp-config.php tiene datos desactualizados.

Cómo solucionarlo paso a paso

Accede a tu panel de control. Si usas Syspanel, ingresa a través del puerto 2106 (ejemplo: tudominio.com:2106).
Ve al administrador de archivos o usa un cliente FTP para localizar el archivo wp-config.php en la raíz de tu instalación de WordPress.
Descarga una copia de seguridad de este archivo antes de editarlo.

Abre el archivo con un editor de texto plano (como Notepad++ o el editor del panel) y busca las líneas que definen la base de datos:

define('DB_NAME', 'nombre_base');
define('DB_USER', 'usuario_base');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');

Verifica que estos datos sean correctos. Puedes comprobarlos en la sección de bases de datos de tu panel (en Syspanel, suele estar en "Bases de datos" o "MySQL").
Si todo está correcto, prueba cambiando DB_HOST de localhost a 127.0.0.1 o al nombre del servidor que te proporcione tu hosting.
Guarda los cambios y sube el archivo de nuevo si lo descargaste.

[TIP] Si después de esto el error persiste, contacta con tu proveedor de hosting. Puede que el servicio de MySQL esté detenido.

Pantalla blanca de la muerte (WSOD)

La temida pantalla en blanco. No ves ningún mensaje de error, solo una página vacía. Esto suele deberse a un error de PHP que no se muestra.

Causas principales

Un plugin o tema incompatible.
Límite de memoria de PHP agotado.
Un error de sintaxis en el archivo functions.php de tu tema.

Pasos para recuperar tu sitio

Accede por FTP o al administrador de archivos de Syspanel (puerto 2106).
Navega a la carpeta wp-content/plugins y renómbrala a plugins_old. Esto desactivará todos los plugins de golpe.
Vuelve a cargar tu web. Si funciona, el problema está en uno de los plugins. Ahora puedes renombrar la carpeta a plugins de nuevo y desactivar los plugins uno por uno desde el panel de administración de WordPress.
Si el error continúa, el problema puede ser del tema. Ve a wp-content/themes y renombra la carpeta de tu tema activo (por ejemplo, tu-tema a tu-tema_old). WordPress cargará automáticamente un tema por defecto (Twenty Twenty-Four, por ejemplo).
Si aún así no funciona, aumenta el límite de memoria. Edita el archivo wp-config.php y añade esta línea antes de /* That's all, stop editing! */:
```
define('WP_MEMORY_LIMIT', '256M');
```

[WARNING] Si no ves el sitio ni siquiera con el tema por defecto, puede que tengas un error de PHP más grave. Revisa los logs de error del servidor (en Syspanel suelen estar en "Registros" o "Logs").

Error 500 - Error interno del servidor

Este error es genérico y puede tener mil causas. La buena noticia es que suele ser fácil de solucionar.

Diagnóstico rápido

Revisa el archivo .htaccess. Conéctate por FTP o al administrador de archivos de Syspanel y localiza el archivo .htaccess en la raíz de WordPress.
Renómbralo a .htaccess_old y recarga tu web. Si funciona, el problema está en ese archivo.
Regenera el archivo. Ve a Ajustes > Enlaces permanentes en tu panel de WordPress y haz clic en "Guardar cambios" sin modificar nada. Esto creará un nuevo .htaccess limpio.
Si el error persiste, aumenta la memoria de PHP como indicamos en el punto anterior.
Otra causa común: permisos de archivos incorrectos. Los archivos deben tener permiso 644 y las carpetas 755. En Syspanel puedes ajustar permisos desde el administrador de archivos con un clic derecho.

[INFO] Un error 500 también puede deberse a un plugin que consume muchos recursos. Sigue los pasos de la pantalla blanca para desactivarlos.

El editor de bloques (Gutenberg) no funciona o da error

A veces el editor de WordPress se queda cargando, no responde o muestra un mensaje de error. Esto suele estar relacionado con JavaScript.

Soluciones prácticas

Limpia la caché de tu navegador y de cualquier plugin de caché que tengas instalado.
Desactiva todos los plugins temporalmente (como ya vimos) para descartar conflictos.
Actualiza WordPress a la última versión. Ve a Escritorio > Actualizaciones y haz clic en "Actualizar ahora".
Reinstala WordPress. Desde la misma pantalla de actualizaciones, puedes hacer clic en "Volver a instalar la versión actual". Esto no borrará tu contenido.
Revisa la consola de errores del navegador (F12 > Consola) para ver si hay algún error de JavaScript específico.

[TIP] Si usas un tema muy antiguo, puede que no sea compatible con el editor de bloques. Considera cambiar a un tema moderno como Twenty Twenty-Four.

Problemas con la carga de imágenes (error HTTP)

Al subir imágenes, a veces aparece "Error HTTP" o "Error al subir el archivo". Esto suele deberse a límites de tamaño o permisos.

Cómo arreglarlo

Aumenta el límite de subida de archivos. Puedes hacerlo desde el archivo wp-config.php añadiendo:

@ini_set( 'upload_max_size' , '64M' );
@ini_set( 'post_max_size', '64M' );
@ini_set( 'memory_limit', '256M' );

O desde el archivo .htaccess añadiendo:

php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value memory_limit 256M

Verifica los permisos de la carpeta wp-content/uploads. Debe tener permiso 755. En Syspanel, puedes hacerlo desde el administrador de archivos.
Desactiva plugins de seguridad o firewall que puedan estar bloqueando las subidas.
Prueba con una imagen más pequeña (menos de 2MB) para descartar que sea un problema de tamaño.

[WARNING] Si ninguna de estas soluciones funciona, puede que tu hosting tenga un límite de subida muy restrictivo. Consulta con tu proveedor.

El sitio se carga muy lento

La velocidad de carga es crucial para el SEO y la experiencia del usuario. Si tu WordPress va lento, prueba estas soluciones.

Optimización básica

Instala un plugin de caché (como W3 Total Cache o WP Super Cache) y actívalo.
Optimiza las imágenes antes de subirlas. Usa herramientas como TinyPNG o plugins como Smush.
Reduce el número de plugins. Cada plugin consume recursos. Desactiva los que no uses.
Actualiza todo: WordPress, temas y plugins. Las versiones antiguas suelen ser más lentas y vulnerables.
Revisa tu hosting. Si compartes servidor y hay mucho tráfico, puede ser momento de escalar a un plan mejor.

[INFO] En Syspanel puedes ver el uso de recursos de tu sitio en la sección "Estadísticas" o "Monitor". Si ves que la CPU o RAM están al límite, contacta con soporte.

Error "Lo sentimos, no tienes permiso para acceder a esta página"

Este error suele aparecer al intentar entrar al panel de administración o a una página específica.

Causas y soluciones

Problema con los plugins de seguridad. Desactívalos temporalmente (renombrando la carpeta wp-content/plugins).
Revisa los roles de usuario. Si eres administrador, ve a Usuarios > Tu perfil y asegúrate de que tu rol sea "Administrador".
Limpia la caché del navegador y del plugin de caché.
Revisa el archivo .htaccess como vimos antes. Un error en las reglas puede bloquear el acceso.

[TIP] Si el error ocurre solo en una página, puede que el plugin de páginas o el tema tenga una restricción. Prueba desactivando el tema por defecto.

Preguntas frecuentes (FAQ)

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

Puedes acceder directamente a la base de datos desde Syspanel (puerto 2106) y cambiar tu contraseña de administrador desde la tabla wp_users. O usa la opción "¿Has olvidado tu contraseña?" en la pantalla de login.

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

Desactiva todos los plugins renombrando la carpeta wp-content/plugins. Luego actívalos uno por uno desde el panel de administración hasta que el error reaparezca. Ese será el culpable.

¿Es seguro reinstalar WordPress?

Sí, reinstalar WordPress desde el panel de actualizaciones no borra tu contenido (posts, páginas, usuarios, etc.). Solo reemplaza los archivos del núcleo de WordPress.

¿Qué hago si mi sitio se infecta con malware?

Primero, cambia todas tus contraseñas (WordPress, FTP, base de datos). Luego, reinstala WordPress y todos los plugins/temas desde fuentes oficiales. Si el problema persiste, contacta con tu proveedor de hosting.

¿Cómo puedo hacer una copia de seguridad antes de probar estas soluciones?

En Syspanel, puedes ir a la sección "Copias de seguridad" y generar un backup completo de tu sitio. También puedes usar plugins como UpdraftPlus para hacerlo desde WordPress.

Esperamos que esta guía te haya sido de ayuda. Recuerda que la mayoría de los errores en WordPress tienen solución y que, con un poco de paciencia y siguiendo estos pasos, podrás tener tu sitio funcionando de nuevo en pocos minutos. Si tienes dudas adicionales, no dudes en consultar la documentación de tu panel de control o contactar con el soporte técnico de tu hosting.