Error 500 en WordPress con DirectAdmin | Solución paso a paso

¡Qué susto ver un error 500 en tu web de WordPress! Esa pantalla en blanco o mensaje genérico de "Error interno del servidor" puede ser desesperante, pero no te preocupes: en la mayoría de los casos tiene solución y tú mismo puedes hacerlo. Este error suele ser un problema de comunicación entre WordPress y tu servidor, y desde el panel de control DirectAdmin podemos rastrear la causa.

En esta guía te explicaré paso a paso cómo solucionar error 500 en WordPress con DirectAdmin, desde lo más básico hasta técnicas más avanzadas usando los logs. No necesitas ser un experto en Linux, solo seguir las instrucciones con calma.

¿Qué es el error 500 y por qué aparece?

El error 500 es un código de estado HTTP que indica "Error interno del servidor". Significa que el servidor web (Apache o Nginx) no puede procesar tu solicitud porque algo falló en la configuración o en el código de tu sitio. Las causas más comunes en WordPress son:

Plugin o tema corrupto o incompatible (la causa más frecuente).
Límite de memoria de PHP excedido.
Archivo .htaccess dañado.
Permisos de archivos incorrectos.
Problemas con el archivo wp-config.php.
Configuración de PHP incorrecta (versión, extensiones).

Lo bueno es que DirectAdmin nos da herramientas para identificar el problema rápidamente.

Paso 1: Identificar el error con los logs (lo más importante)

Antes de tocar nada, debemos mirar los logs del servidor. Los logs son archivos de texto donde se registran todos los errores. Si no los revisas, estarás adivinando.

### Acceder a los logs de error en DirectAdmin

Inicia sesión en DirectAdmin (normalmente en http://tudominio.com:2222).
Ve a "Gestión de Sitios Web" o "Administrador de sitios" (depende de la versión).
Busca tu dominio y haz clic en el icono de "Registros de Errores" o "Error Logs".
Verás una lista de archivos. El más importante es error_log (a veces llamado error.log). Haz clic en él para ver su contenido.

[INFO] Si no ves el enlace directo, puedes ir a "Herramientas Avanzadas" > "Visor de Logs" y seleccionar tu dominio.

### Leer el log como un detective

El log te mostrará líneas como esta:

[01-Oct-2024 10:15:23 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function wp_get_current_user() in /home/usuario/public_html/wp-includes/capabilities.php:23

Traducción: "Error fatal de PHP: Llamada a función no definida". Esto indica que un archivo de WordPress está roto o falta.

¿Qué buscar?

"PHP Fatal error": Error grave que detiene la ejecución.
"Allowed memory size": Límite de memoria alcanzado.
"Parse error": Error de sintaxis en un archivo.
"require_once" o "include": Archivo no encontrado.
Nombre de un plugin o tema: Por ejemplo, /wp-content/plugins/mi-plugin/mi-archivo.php.

Si el log está vacío o no muestra nada, puede que el error se esté registrando en otro lugar (como el log de Apache). En ese caso, sigue al paso 2.

Paso 2: Soluciones rápidas sin tocar código (para principiantes)

Si no te sientes cómodo leyendo logs, prueba estas soluciones básicas. Son seguras y resuelven el 80% de los casos.

### 1. Desactivar todos los plugins por FTP o gestor de archivos

Los plugins conflictivos son la causa número 1. Puedes desactivarlos manualmente sin entrar al panel de administración de WordPress.

En DirectAdmin, ve a "Administrador de Archivos".
Navega a public_html/wp-content/plugins/.
Verás carpetas de todos tus plugins. Renombra la carpeta de un plugin (por ejemplo, akismet -> akismet_desactivado). Esto lo desactiva.
Haz lo mismo con todos los plugins (o renombra la carpeta completa plugins a plugins_old para desactivarlos todos a la vez).
Recarga tu web. Si funciona, el problema está en uno de los plugins. Ve reactivándolos uno a uno (renombrando a su nombre original) hasta encontrar el culpable.

### 2. Cambiar a un tema por defecto de WordPress

Un tema corrupto también puede causar el error 500.

En el Administrador de Archivos, ve a public_html/wp-content/themes/.
Verás las carpetas de tus temas. Renombra la carpeta de tu tema activo (por ejemplo, mi-tema -> mi-tema_old).
WordPress automáticamente usará un tema por defecto (Twenty Twenty-Four, etc.). Si la web carga, el tema era el problema.

### 3. Restaurar el archivo .htaccess por defecto

El .htaccess es un archivo de configuración de Apache que a veces se corrompe.

En DirectAdmin, ve a public_html/.
Busca el archivo .htaccess (puede estar oculto; activa "Mostrar archivos ocultos" en el Administrador de Archivos).
Renómbralo a .htaccess_old.
Crea un nuevo archivo .htaccess vacío (o sube uno limpio).
Luego, ve a Ajustes > Enlaces permanentes en tu WordPress (si puedes acceder) y haz clic en "Guardar cambios" para regenerarlo.

[WARNING] Si no puedes acceder a WordPress, puedes copiar este código básico en el nuevo .htaccess:

# 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

Paso 3: Soluciones avanzadas (usando DirectAdmin y PHP)

Si las soluciones rápidas no funcionaron, profundicemos.

### Aumentar el límite de memoria de PHP

Un error común es "Allowed memory size of 268435456 bytes exhausted". Para aumentarlo:

En DirectAdmin, ve a "Configuración de PHP" o "Selector de PHP" (a veces en "Características adicionales").
Busca la opción "memory_limit" y cámbiala a 256M o 512M.
Guarda los cambios. Si no ves esa opción, puedes hacerlo manualmente:
- Ve al Administrador de Archivos y abre public_html/wp-config.php.
- Agrega esta línea justo antes del comentario "/* That's all, stop editing! */":
```
define('WP_MEMORY_LIMIT', '512M');
```

### Verificar la versión de PHP y extensiones

WordPress necesita al menos PHP 7.4 (recomendado 8.0+). En DirectAdmin:

Ve a "Configuración de PHP" y selecciona una versión más reciente (por ejemplo, 8.1 o 8.2).
Asegúrate de que las extensiones mysqli, mbstring, curl, xml, gd estén habilitadas.

### Comprobar permisos de archivos

Los permisos incorrectos pueden bloquear la lectura de archivos. En DirectAdmin:

En el Administrador de Archivos, selecciona la carpeta public_html.
Haz clic en "Cambiar permisos" (o "Chmod").
Establece:
- Carpetas: 755
- Archivos: 644
- wp-config.php: 600 (más seguro)
También puedes usar la herramienta "Reparar permisos" si está disponible en tu DirectAdmin.

Paso 4: Si todo falla, restaura una copia de seguridad

Si has llegado hasta aquí y el error persiste, no desesperes. DirectAdmin suele incluir Backups automáticos.

Ve a "Copia de seguridad" o "Backup" en DirectAdmin.
Selecciona una copia reciente (de antes del error).
Restaura solo los archivos (no la base de datos si no es necesario) o haz una restauración completa.

[TIP] Siempre ten un backup a mano. En DirectAdmin puedes programar backups semanales.

FAQ: Preguntas frecuentes sobre el error 500 en WordPress con DirectAdmin

¿El error 500 puede deberse a un ataque?

Sí, a veces un plugin de seguridad bloquea algo o un archivo se infecta. Revisa los logs en busca de actividad sospechosa.

¿Qué hago si no veo los logs en DirectAdmin?

Puedes acceder por FTP al archivo error_log en la raíz de tu dominio (public_html/error_log). Si no existe, el error puede estar en el log del servidor (pide ayuda a tu hosting).

¿Y si el error aparece solo en una página específica?

Es probable que sea un plugin o un shortcode problemático. Desactiva plugins uno a uno y prueba.

¿Puedo usar el modo de depuración de WordPress?

Sí. Agrega esta línea en wp-config.php:

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

Luego revisa el archivo wp-content/debug.log que se generará.

¿Qué pasa si el error es por el archivo .htaccess y no puedo acceder a WordPress?

Renómbralo como te expliqué. Si el problema persiste, puede ser que tu servidor use Nginx (no Apache). En ese caso, el .htaccess no sirve y el error está en otro lado.

¿DirectAdmin tiene alguna herramienta para diagnosticar errores 500?

Sí, además de los logs, puedes usar "PHP Info" en "Configuración de PHP" para ver la configuración actual. También el "Visor de Logs" es muy útil.

Conclusión: No le temas al error 500

El error 500 en WordPress es como un dolor de cabeza: molesto pero casi siempre tratable. Con DirectAdmin tienes todas las herramientas para diagnosticarlo y solucionarlo: logs, administrador de archivos, configuración de PHP y backups.

Recuerda el orden lógico:

Revisa los logs (siempre primero).
Prueba soluciones rápidas (plugins, tema, .htaccess).
Ajusta PHP (memoria, versión).
Restaura un backup si nada funciona.

Y si en algún momento te sientes perdido, tu proveedor de hosting (especialmente si usa Syspanel en lugar de DirectAdmin, que usa el puerto 2106) puede ayudarte. Pero con esta guía, la mayoría de los casos los resolverás tú mismo.

¡Manos a la obra y a recuperar tu web!