Errores comunes en WordPress y cómo solucionarlos con DirectAdmin

Si estás leyendo esto, probablemente te has encontrado con algún mensaje de error en tu sitio WordPress y necesitas ayuda para solucionarlo. No te preocupes, es más común de lo que crees. Como técnico de soporte, te guiaré paso a paso para resolver los errores WordPress DirectAdmin más frecuentes, usando las herramientas que tienes a tu disposición en tu panel de control.

WordPress es un software increíblemente potente, pero a veces puede dar problemas. La clave está en saber identificar el error y aplicar la solución correcta. DirectAdmin es una herramienta excelente para gestionar tu hosting, y te permitirá acceder a archivos, bases de datos y logs para solucionar error WordPress de forma rápida y segura.

Vamos a empezar por los problemas más comunes y cómo atajarlos. Recuerda que siempre puedes consultar la documentación oficial de WordPress o contactar con tu proveedor de hosting si necesitas ayuda adicional.

El temido "Error 500 Internal Server Error" en WordPress

El 500 error WordPress es uno de los más frustrantes porque no da pistas claras. Aparece una pantalla en blanco o un mensaje genérico. La causa suele ser un problema en el servidor, a menudo relacionado con un plugin o tema defectuoso, o con un archivo .htaccess corrupto.

Causas más comunes del error 500

• Plugin o tema conflictivo: Una actualización reciente o un plugin mal codificado puede romper la comunicación con el servidor.
• Archivo .htaccess dañado: Este archivo controla reglas de reescritura y permisos. Si se corrompe, el servidor no sabe cómo procesar las peticiones.
• Límite de memoria PHP excedido: Si tu sitio requiere más memoria de la que el servidor tiene asignada, se produce un error 500.
• Problemas con el archivo wp-config.php: Una modificación incorrecta en este archivo puede dejar tu sitio inaccesible.

Cómo solucionarlo desde DirectAdmin

1. Accede a DirectAdmin: Inicia sesión en tu panel de control. Normalmente es algo como tudominio.com:2222.
2. Ve a "Administrador de archivos": Busca la sección de "Archivos" o "File Manager". Es tu navaja suiza para acceder a todos los archivos de tu sitio.
3. Localiza la carpeta de tu sitio: Normalmente está en public_html o en una subcarpeta como public_html/tusitio.
4. Desactiva todos los plugins (método manual):
   • Dentro de la carpeta de tu sitio, busca la carpeta wp-content.
   • Dentro de wp-content, verás una carpeta llamada plugins. No la borres, solo cámbiale el nombre a plugins_desactivados.
   • Esto fuerza a WordPress a no cargar ningún plugin. Si el error desaparece, sabrás que el problema está en uno de ellos.
   • Para identificar el culpable, ve renombrando la carpeta a plugins de nuevo y luego desactivando los plugins uno por uno desde el panel de administración de WordPress (si logras acceder).
5. Restaura el archivo .htaccess:
   • En el "Administrador de archivos", busca el archivo .htaccess en la raíz de tu sitio (carpeta public_html o la que corresponda).
   • Renómbralo a .htaccess_old para desactivarlo.
   • Ahora, intenta acceder a tu sitio. Si funciona, el problema está en ese archivo.
   • Para regenerar uno nuevo, ve a Ajustes > Enlaces permanentes en tu panel de WordPress (si puedes acceder) y haz clic en "Guardar cambios". WordPress creará un .htaccess limpio.
6. Aumenta el límite de memoria PHP:
   • Vuelve al "Administrador de archivos".
   • Busca el archivo wp-config.php en la raíz de tu sitio.
   • Ábrelo con el editor de texto.
   • Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! ¡Feliz blogging! */, añade esta línea:
     define('WP_MEMORY_LIMIT', '256M');
   • Guarda los cambios. Esto le da más memoria a WordPress.

[INFO] Si después de estos pasos el error persiste, revisa los logs de error del servidor en DirectAdmin (suele estar en "Logs" o "Error Logs"). Busca la línea que coincida con la hora del error. A menudo verás algo como "PHP Fatal error: Allowed memory size of..." que te dará la pista definitiva.

Error de conexión a la base de datos

Este error es muy común y suele mostrar el mensaje: "Error establishing a database connection". Es frustrante, pero casi siempre tiene solución. La base de datos WordPress es el corazón de tu sitio, y si no se conecta, todo se para.

Causas más comunes

• Credenciales incorrectas: El archivo wp-config.php tiene el nombre de la base de datos, el usuario y la contraseña equivocados.
• Servidor de base de datos caído: A veces el servicio MySQL/MariaDB se detiene.
• Base de datos corrupta: Una mala actualización o un plugin pueden dañar las tablas.
• Usuario sin permisos: El usuario de la base de datos puede no tener permisos para acceder a ella.

Cómo solucionarlo desde DirectAdmin

1. Verifica las credenciales en wp-config.php:
   • Ve al "Administrador de archivos" en DirectAdmin.
   • Abre el archivo wp-config.php de tu sitio.
   • Busca estas líneas:

     define('DB_NAME', 'nombre_de_tu_bd');
     define('DB_USER', 'usuario_de_tu_bd');
     define('DB_PASSWORD', 'contraseña_de_tu_bd');
     define('DB_HOST', 'localhost');
     

   • Comprueba que estos datos sean exactamente los mismos que tienes en tu base de datos. Un error tipográfico es la causa más frecuente.
2. Accede a phpMyAdmin desde DirectAdmin:
   • En DirectAdmin, busca la sección "Base de Datos" o "MySQL Management". Verás un enlace a "phpMyAdmin".
   • Inicia sesión con el usuario y contraseña de tu base de datos (los mismos de wp-config.php).
3. Repara y optimiza la base de datos:
   • Dentro de phpMyAdmin, selecciona tu base de datos en el panel izquierdo.
   • Verás una lista de todas las tablas (normalmente empiezan por wp_).
   • Marca la casilla de "Seleccionar todo" en la parte inferior.
   • En el menú desplegable "Con seleccionados", elige "Reparar tabla". Esto intenta arreglar cualquier corrupción.
   • Después, repite el proceso y elige "Optimizar tabla". Esto no es esencial, pero ayuda al rendimiento.
4. Revisa el usuario y los permisos:
   • En DirectAdmin, ve a "MySQL Management".
   • Busca tu base de datos y haz clic en "Editar" o "Gestionar".
   • Asegúrate de que el usuario correcto está asociado a la base de datos y tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Si no es así, asígnaselos.

[WARNING] Si cambias la contraseña de la base de datos desde DirectAdmin, debes actualizarla también en el archivo wp-config.php de tu sitio. Si no, perderás la conexión.

Problemas con plugins y temas

Los plugins y temas son extensiones que añaden funcionalidades, pero a veces entran en conflicto o se actualizan mal.

Síntomas comunes

• Pantalla blanca de la muerte (WSOD): El sitio no carga nada, solo una página en blanco.
• Errores de estilo: El sitio se ve raro, sin CSS, o con elementos desordenados.
• Errores de JavaScript: Funcionalidades como menús desplegables o sliders no funcionan.
• El panel de administración no carga.

Cómo solucionarlo desde DirectAdmin

1. Identificar el conflicto (método de desactivación manual):
   • Como vimos antes, renombra la carpeta wp-content/plugins a wp-content/plugins_desactivados.
   • Si el sitio vuelve a funcionar, el problema está en un plugin.
   • Para encontrar cuál, renombra la carpeta a plugins otra vez. Luego, desde el panel de administración de WordPress (si puedes acceder), desactiva los plugins uno por uno hasta que el error desaparezca.
2. Restaurar un tema por defecto:
   • A veces el tema es el problema. Para probar, renombra la carpeta de tu tema activo dentro de wp-content/themes. Por ejemplo, si tu tema se llama mi-tema, cámbialo a mi-tema_desactivado.
   • WordPress, al no encontrar el tema, cargará automáticamente uno de los temas por defecto (como Twenty Twenty-Four). Si el sitio funciona, tu tema es el culpable.
3. Reinstalar un plugin o tema:
   • Si identificas el plugin o tema problemático, la mejor solución es eliminarlo por completo desde el "Administrador de archivos" de DirectAdmin (borra su carpeta dentro de wp-content/plugins o wp-content/themes).
   • Luego, vuelve a instalarlo desde el panel de WordPress (Apariencia > Temas o Plugins > Añadir nuevo). Esto asegura que se descargue la última versión limpia.

[TIP] Siempre mantén una copia de seguridad de tu sitio antes de hacer cambios grandes. DirectAdmin suele tener una herramienta de backup en la sección "Cuenta" o "Backup". Úsala.

Error de memoria PHP (Allowed memory size exhausted)

Este error es muy específico y suele aparecer como: "Fatal error: Allowed memory size of X bytes exhausted". Significa que tu sitio está intentando usar más memoria de la que el servidor le permite.

Cómo solucionarlo desde DirectAdmin

1. Aumenta el límite en wp-config.php (como vimos antes):
   • Añade define('WP_MEMORY_LIMIT', '256M'); en tu wp-config.php.
2. Aumenta el límite en php.ini:
   • Si el paso anterior no funciona, necesitas modificar el archivo php.ini de tu sitio.
   • En el "Administrador de archivos", busca un archivo llamado php.ini en la raíz de tu sitio (si no existe, créalo).
   • Añade o modifica esta línea:
     memory_limit = 256M
   • Guarda el archivo.
3. Pide a tu hosting que aumente el límite global:
   • Si no puedes modificarlo, contacta con tu proveedor de hosting. A veces el límite está fijado a nivel de servidor y ellos pueden aumentarlo.

Error de "White Screen of Death" (WSOD)

La pantalla blanca es un síntoma de varios problemas, pero a menudo se debe a un error fatal de PHP. Es como un apagón total.

Pasos para diagnosticar desde DirectAdmin

1. Activa el modo debug de WordPress:
   • Abre tu archivo wp-config.php.
   • Busca la línea define('WP_DEBUG', false); y cámbiala a define('WP_DEBUG', true);.
   • También añade estas líneas justo debajo:
     define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
   • Esto hará que WordPress registre los errores en un archivo llamado debug.log dentro de la carpeta wp-content.
2. Revisa el archivo debug.log:
   • Ve a wp-content en el "Administrador de archivos".
   • Busca el archivo debug.log. Ábrelo y verás los errores exactos que están ocurriendo. Te dirán el plugin, tema o archivo problemático.
3. Activa un tema por defecto y desactiva plugins (como ya vimos).
4. Aumenta la memoria PHP (como ya vimos).

Error de "Conexión segura fallida" o "ERR_SSL_PROTOCOL_ERROR"

Esto ocurre cuando hay un problema con el certificado SSL de tu sitio.

Cómo solucionarlo desde DirectAdmin

1. Verifica que el SSL esté instalado:
   • En DirectAdmin, busca la sección "SSL Certificates" o "Let's Encrypt SSL".
   • Asegúrate de que tu dominio tiene un certificado activo.
2. Renueva o reinstala el SSL:
   • Si está caducado o no funciona, usa la opción "Renew" o "Issue" para obtener uno nuevo de Let's Encrypt (gratuito).
3. Forza HTTPS en WordPress:
   • Si ya tienes SSL, pero el sitio sigue cargando en HTTP, añade estas líneas a tu wp-config.php:

     define('FORCE_SSL_ADMIN', true);
     

   • En el panel de administración de WordPress, ve a Ajustes > Generales y cambia las URLs de "WordPress Address" y "Site Address" para que empiecen con https://.

Preguntas Frecuentes (FAQ)

¿Cómo accedo a DirectAdmin?

Normalmente es a través de tudominio.com:2222. Si usas un panel alternativo como Syspanel, el puerto es el 2106.

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

Usa DirectAdmin para desactivar plugins y temas manualmente, como hemos explicado. También puedes reparar la base de datos desde phpMyAdmin.

¿Cómo hago una copia de seguridad desde DirectAdmin?

Ve a la sección "Cuenta" o "Backup" en DirectAdmin. Puedes generar una copia completa de tu sitio (archivos y base de datos) y descargarla.

¿Qué es el archivo .htaccess y por qué es importante?

Es un archivo de configuración del servidor Apache. Controla reglas de reescritura de URLs (permalink), redirecciones y seguridad. Si se daña, tu sitio puede dar errores.

¿Puedo instalar WordPress desde DirectAdmin?

Sí, muchos paneles de control tienen un instalador automático (como Softaculous) en la sección "Scripts" o "Instaladores". Busca WordPress y sigue los pasos.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia y la metodología son clave para solucionar error WordPress. Empieza siempre por lo más simple y ve avanzando. Si el problema persiste, no dudes en buscar ayuda profesional o contactar con tu soporte técnico. ¡Buena suerte con tu sitio!