Errores comunes de WordPress y cómo solucionarlos (white screen, error 500, base de datos)

Tu sitio WordPress está caído. La pantalla está en blanco, aparece un "Error 500" o ves un mensaje de "Error al establecer la conexión con la base de datos". Cualquiera de estos escenarios es estresante, especialmente si tu sitio genera ingresos directos.

La buena noticia: la mayoría de los errores de WordPress tienen solución y siguen un patrón reconocible. En esta guía te mostramos cómo diagnosticar y resolver los problemas más frecuentes, incluso sin acceso a wp-admin.

White Screen of Death (WSOD): pantalla en blanco

El White Screen of Death es uno de los errores más comunes y frustrantes en WordPress. El sitio carga, pero muestra solo una pantalla completamente en blanco, sin mensaje de error visible.

Causas más frecuentes

• Plugin o tema incompatible instalado recientemente
• Agotamiento del límite de memoria PHP
• Error de sintaxis en functions.php u otro archivo PHP
• Actualización de PHP a una versión incompatible con algún plugin

Cómo diagnosticarlo y resolverlo

Paso 1: Activa el modo debug de WordPress

Accede a tu hosting por FTP o desde el administrador de archivos de cPanel. Edita el archivo wp-config.php en la raíz de tu sitio y agrega o modifica estas líneas:

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

Esto registra los errores en /wp-content/debug.log sin mostrarlos en pantalla. Lee ese archivo para identificar la causa exacta.

Paso 2: Desactiva todos los plugins

Desde el administrador de archivos de cPanel, entra a wp-content/plugins/ y renombra la carpeta plugins a plugins_backup. Recarga el sitio. Si el error desaparece, uno de los plugins era el culpable. Restaura el nombre de la carpeta y luego desactiva plugins uno a uno desde wp-admin para identificar cuál.

Paso 3: Cambia al tema por defecto

Si desactivar plugins no resolvió el problema, entra a wp-content/themes/ y renombra tu tema activo. WordPress usará automáticamente el tema por defecto (Twenty Twenty-Four o similar). Si el sitio vuelve, el problema estaba en el tema.

Paso 4: Aumenta el límite de memoria

Agrega esta línea al archivo wp-config.php:

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

También puedes agregarlo en el .htaccess de la raíz: php_value memory_limit 256M.

Error 500: Internal Server Error

El error HTTP 500 indica un problema en el servidor o en el código que WordPress ejecuta. El servidor falló, pero no puede decirte exactamente por qué.

Causas más frecuentes

• Archivo .htaccess corrupto o con reglas incorrectas
• Plugin incompatible con la versión de PHP del servidor
• Límite de ejecución PHP agotado (max_execution_time)
• Permisos incorrectos en archivos o carpetas

Cómo resolverlo

Paso 1: Regenera el .htaccess

Entra al administrador de archivos de cPanel, localiza el archivo .htaccess en la raíz de tu instalación WordPress y renómbralo a .htaccess_backup. Luego crea un .htaccess nuevo con el contenido estándar de WordPress:

# 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

Recarga el sitio. Si el error 500 desaparece, el problema estaba en el .htaccess original.

Paso 2: Revisa los logs de error en cPanel

En cPanel ve a Métricas → Errores o busca la sección de logs del servidor. Allí encontrarás mensajes específicos como PHP Fatal error, que te indicarán exactamente qué archivo y qué línea causó el problema.

Paso 3: Revisa los permisos de archivos

Los permisos correctos en WordPress son:

• Carpetas: 755
• Archivos: 644
• wp-config.php: 600 (más restrictivo por seguridad)

Desde cPanel puedes ajustar permisos en el administrador de archivos con clic derecho → "Cambiar permisos".

Paso 4: Desactiva plugins vía FTP

Si el error aparece después de instalar un plugin, renombra la carpeta del plugin en wp-content/plugins/ para desactivarlo sin acceder a wp-admin.

Error de conexión a la base de datos

El mensaje "Error al establecer la conexión con la base de datos" o "Error establishing a database connection" aparece cuando WordPress no puede conectarse a MySQL. Es alarmante pero casi siempre tiene solución.

Causas más frecuentes

• Credenciales de base de datos incorrectas en wp-config.php
• La base de datos fue eliminada o el usuario perdió sus permisos
• El servidor MySQL está temporalmente caído o sobrecargado
• Las tablas de la base de datos están corruptas

Cómo resolverlo

Paso 1: Verifica las credenciales en wp-config.php

Abre wp-config.php y confirma que estos valores sean correctos:

define('DB_NAME', 'nombre_de_tu_base_datos');
define('DB_USER', 'usuario_de_mysql');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');

Los datos correctos los encuentras en cPanel → Bases de datos MySQL → ver el usuario y la base de datos asignados a tu sitio.

Paso 2: Repara las tablas con phpMyAdmin

Entra a cPanel → phpMyAdmin. Selecciona tu base de datos, luego marca todas las tablas y en el menú "Con las seleccionadas" elige "Reparar tabla". Esto resuelve problemas de corrupción de tablas.

Paso 3: Prueba la conexión con un script

Si sospechas que las credenciales son el problema, crea un archivo test-db.php en la raíz con este contenido, luego elimínalo inmediatamente después de probarlo:

<?php
$conn = new mysqli('localhost', 'tu_usuario', 'tu_password', 'tu_base_datos');
if ($conn->connect_error) {
    die('Error: ' . $conn->connect_error);
}
echo 'Conexión exitosa';

¿Tu WordPress lleva horas caído y no puedes resolverlo? Nuestro soporte técnico especializado está disponible para ayudarte → Contactar soporte

Errores después de actualizar PHP

Si tu hosting cambió la versión de PHP y tu WordPress dejó de funcionar, es probable que algún plugin o tema sea incompatible con la nueva versión.

Síntomas

• White Screen of Death justo después del cambio de PHP
• Error 500 en páginas específicas
• Mensajes de "Deprecated" o "Fatal error" en los logs

Cómo resolverlo

Opción 1: Revierte la versión de PHP temporalmente

Desde cPanel, busca la sección "Seleccionar versión de PHP" o MultiPHP Manager. Cambia la versión de PHP de tu dominio a la anterior. Esto te da tiempo para actualizar los plugins incompatibles sin dejar el sitio caído.

Consulta nuestra guía sobre cómo actualizar la versión de PHP en WordPress desde cPanel para hacerlo de forma controlada.

Opción 2: Identifica y actualiza los plugins incompatibles

Con PHP revertido, entra a wp-admin → Plugins → Verifica si hay actualizaciones pendientes. Actualiza cada plugin y luego prueba incrementalmente con la nueva versión de PHP hasta identificar cuál es el incompatible.

Errores después de instalar o mover un sitio

Si migraste WordPress desde otro servidor o dominio y ahora el sitio no funciona correctamente, los problemas más comunes son:

URLs incorrectas en la base de datos

Al mover un sitio, las URLs del dominio anterior quedan guardadas en la base de datos. Usa el plugin Search & Replace Everything o el script CLI wp search-replace para actualizarlas:

wp search-replace 'https://dominioviejo.com' 'https://dominuionuevo.cl' --all-tables

Permisos de archivos incorrectos después de la migración

Al copiar archivos entre servidores, los permisos pueden cambiar. Aplica los permisos correctos (755 carpetas / 644 archivos) desde el administrador de archivos de cPanel.

wp-config.php con datos del servidor anterior

Edita wp-config.php para actualizar DB_NAME, DB_USER, DB_PASSWORD y DB_HOST con los datos del nuevo servidor.

Diagnóstico sin acceso a wp-admin: usando logs de cPanel

Cuando no puedes entrar a wp-admin, los logs del servidor son tu mejor aliado.

Dónde encontrar los logs en cPanel:

• Métricas → Errores: muestra los últimos errores PHP y del servidor
• Administrador de archivos → wp-content/debug.log: log de WordPress si tienes WP_DEBUG activado
• Métricas → Ancho de banda: puede revelar ataques de tráfico que saturaron el sitio

Lee los mensajes de error de abajo hacia arriba. El primer error en cronología suele ser la causa raíz, los demás son consecuencias en cascada.

Prevención: cómo evitar estos errores en el futuro

La mayoría de los errores graves en WordPress se pueden prevenir con tres hábitos:

1. Backups diarios automáticos

Si tu hosting no incluye backups automáticos, estás expuesto. Con backups diarios, el peor escenario es perder un día de trabajo, no todo el sitio. Consulta nuestra guía sobre cómo hacer backup de WordPress desde cPanel.

2. Entorno de staging para probar actualizaciones

Antes de actualizar WordPress, plugins o el tema en producción, prueba todo en una copia de staging. Así detectas incompatibilidades sin afectar a tus visitantes.

3. Actualizaciones controladas

Actualiza un plugin a la vez, no todos de golpe. Si algo rompe el sitio, sabrás exactamente qué fue. Evita hacer actualizaciones masivas en horarios de alto tráfico.

Preguntas frecuentes

¿Qué hago si no tengo acceso a FTP ni a cPanel?

Contacta a tu proveedor de hosting. Con las credenciales del plan puedes solicitar acceso de emergencia. Si usas Elevocloud, nuestro soporte está disponible para ayudarte a recuperar acceso.

¿El error 500 puede deberse al servidor y no a mi sitio?

Sí. Si el error aparece en todos los sitios del mismo servidor o en momentos puntuales, puede ser una sobrecarga temporal del servidor. En ese caso, espera unos minutos y recarga. Si persiste, reporta el problema a tu proveedor.

¿Puedo resolver estos errores si no tengo conocimientos técnicos?

Los pasos descritos en esta guía no requieren programación. Solo necesitas acceso a cPanel o FTP. Si el problema persiste después de seguir la guía, el soporte técnico especializado de tu hosting puede resolverlo directamente.

¿La reparación de tablas MySQL puede perder datos?

No. La función "Reparar tabla" de phpMyAdmin solo corrige la estructura de las tablas, no elimina datos. Para mayor tranquilidad, haz una exportación de la base de datos antes de reparar.

Tener un WordPress caído es una situación de urgencia, pero con el diagnóstico correcto y las herramientas adecuadas, la mayoría se resuelve en minutos. El mejor seguro es un hosting con backups diarios, staging incluido y soporte técnico especializado en WordPress → Ver planes Elevocloud