Solucionar el error 500 en WordPress: Guía para DirectAdmin

[INFO] Este artículo está pensado para usuarios de WordPress que utilizan el panel de control DirectAdmin. Si tu panel es Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106 y los pasos serán muy similares, pero la ubicación de algunos archivos puede variar ligeramente. Nos centramos en DirectAdmin para que sigas los pasos con precisión.

Ver el temido error 500 en WordPress es una de las experiencias más frustrantes para cualquier administrador de un sitio web. Un momento estás revisando tus estadísticas o escribiendo una nueva entrada y, al siguiente, ves una pantalla en blanco o un mensaje genérico que dice "Error interno del servidor". La buena noticia es que, en la mayoría de los casos, este error no es síntoma de un problema grave y puede solucionarse siguiendo una serie de pasos lógicos y seguros.

En esta guía extensa, nos centraremos específicamente en cómo abordar este problema cuando tu hosting está gestionado a través de DirectAdmin. Este panel es conocido por su potencia y flexibilidad, pero también requiere que el usuario sepa dónde mirar. Vamos a desglosar el proceso de diagnóstico y solución del directadmin error 500 en WordPress, paso a paso, desde lo más simple hasta lo más técnico, para que puedas restaurar tu sitio sin necesidad de ser un experto en programación.

¿Qué significa exactamente el Error 500?

Antes de lanzarnos a tocar archivos, es crucial entender qué está pasando. El código de estado HTTP 500 es un error genérico que indica que algo salió mal en el servidor, pero el servidor no especifica cuál es el problema exacto. Es como si el motor de tu coche se parara, pero el cuadro de mandos no encendiera ninguna luz de aviso concreta.

En el contexto de WordPress, este error suele estar causado por uno de estos tres motivos principales:

1. Un archivo .htaccess corrupto o con reglas incompatibles.
2. Un plugin o tema con un error de PHP que provoca un fallo fatal en el sistema.
3. Límites de memoria del servidor agotados o permisos de archivos incorrectos.

Como el error es tan genérico, nuestro trabajo será ir descartando causas comunes hasta encontrar la culpable. No te preocupes, no necesitas ser un desarrollador para hacerlo. Solo necesitas seguir el orden lógico que te proponemos a continuación.

Preparación: Accede a tu panel de control y a los archivos

Lo primero que necesitas es acceso a dos herramientas:

• DirectAdmin: Para gestionar los archivos y las bases de datos.
• Un cliente FTP o el Administrador de Archivos de DirectAdmin: Para editar y renombrar archivos.

Paso 1: Entra en tu panel de DirectAdmin.

Abre tu navegador y ve a la URL de tu panel. Normalmente suele ser algo como https://tudominio.com:2222 o https://tuip:2222. Introduce tu usuario y contraseña.

Paso 2: Localiza el Administrador de Archivos.

En el menú principal de DirectAdmin, busca el icono que dice "Administrador de Archivos" (File Manager). Haz clic en él. Te llevará a la raíz de tu cuenta de hosting. Deberías ver una carpeta llamada domains o public_html. Haz clic en public_html (o en el dominio específico que estés usando). Aquí es donde están todos los archivos de tu WordPress.

[TIP] Antes de hacer cualquier cambio, es obligatorio hacer una copia de seguridad de los archivos que vayas a tocar. Nunca edites sin una red de seguridad.

Solución 1: Corregir el archivo .htaccess (El primer sospechoso)

El archivo .htaccess es un archivo de configuración que controla cómo el servidor maneja las URLs de tu sitio. Si se corrompe, puede provocar un error 500 wordpress inmediato.

¿Cómo solucionarlo?

1. En el Administrador de Archivos, asegúrate de que tienes activada la opción de "Mostrar archivos ocultos" (a veces viene desactivada por defecto). Busca el archivo llamado .htaccess (empieza con un punto).
2. No lo borres aún. Primero, haz clic derecho sobre él y selecciona "Renombrar". Cámbiale el nombre a algo como .htaccess_backup. Esto desactiva su efecto sin perder la información.
3. Ahora, ve a tu sitio web y comprueba si el error ha desaparecido.

• Si el error desaparece: El problema era el .htaccess. Ahora ve a Ajustes > Enlaces permanentes en tu panel de administración de WordPress (si puedes acceder, claro) y haz clic en "Guardar cambios". Esto generará un archivo .htaccess nuevo y limpio. Si no puedes acceder al panel, simplemente renombra el archivo de backup de nuevo a .htaccess y pasa a la siguiente solución, ya que el problema podría ser una regla específica dentro del archivo.
• Si el error persiste: El .htaccess no era el culpable. Pasa a la siguiente solución.

[INFO] El archivo .htaccess también es un objetivo común para los hackers. Si has estado experimentando otros problemas de seguridad, esta es una buena oportunidad para revisarlo en busca de código extraño.

Solución 2: Desactivar todos los plugins (El conflicto más común)

La causa más frecuente de un error 500 en WordPress es un conflicto entre plugins o un plugin que ha recibido una actualización defectuosa. WordPress carga todos los plugins activos en cada petición, y si uno de ellos tiene un error de PHP fatal, tumbará todo el sitio.

¿Cómo desactivarlos sin entrar al panel?

A veces, el error es tan grave que ni siquiera podemos entrar en /wp-admin. No pasa nada, podemos desactivar los plugins manualmente a través de FTP o del Administrador de Archivos.

1. En el Administrador de Archivos, navega a la carpeta public_html/wp-content/.
2. Dentro de wp-content, verás una carpeta llamada plugins.
3. Haz clic derecho sobre la carpeta plugins y selecciona "Renombrar". Cámbiale el nombre a plugins_desactivados (o plugins_off).
4. Vuelve a tu sitio web.

• Si el error desaparece: ¡Enhorabuena! El problema era uno de tus plugins. Ahora tienes que identificar cuál. Renombra la carpeta de nuevo a plugins y luego, uno por uno, renombra las subcarpetas dentro de plugins (cada plugin tiene su propia carpeta) para desactivarlos individualmente. Empieza por los que tengas más sospechosos (los de caché, seguridad o los que actualizaste recientemente). Ve comprobando el sitio entre cada cambio hasta encontrar al culpable. Una vez lo encuentres, elimina ese plugin o sustitúyelo por una alternativa.
• Si el error persiste: El problema no son los plugins. Renombra la carpeta de nuevo a plugins para dejar todo como estaba.

[WARNING] Si renombras la carpeta plugins y el error persiste, no olvides restaurar el nombre original a plugins. De lo contrario, tu WordPress quedará en un estado extraño.

Solución 3: Cambiar al tema por defecto (Descartando el tema)

Al igual que los plugins, un tema con un error de código puede provocar un fallo fatal.

¿Cómo cambiar de tema manualmente?

1. Ve a public_html/wp-content/themes/.
2. Verás las carpetas de todos tus temas instalados. El que está activo suele tener un nombre que reconocerás.
3. Para desactivarlo, renombra la carpeta del tema activo. Por ejemplo, si tu tema se llama mi-tema-personalizado, cámbiale el nombre a mi-tema-personalizado_desactivado.
4. Importante: WordPress, al no encontrar el tema activo, intentará cargar un tema por defecto (como Twenty Twenty-Four). Si no tienes ninguno por defecto, puede que el sitio falle de nuevo. Para estar seguros, es recomendable tener siempre instalado un tema por defecto.
5. Comprueba tu sitio web.

• Si el error desaparece: El problema está en tu tema. Puedes intentar actualizarlo, o si el error persiste, tendrás que contactar con el desarrollador del tema o buscar una alternativa.
• Si el error persiste: Restaura el nombre de la carpeta del tema y sigue con la siguiente solución.

Solución 4: Aumentar el límite de memoria de PHP (Límites del servidor)

A veces, el error no es por un archivo corrupto, sino por falta de recursos. WordPress tiene un límite de memoria por defecto, y si un plugin o el propio núcleo necesita más, puede lanzar un error 500. Esto es especialmente común si has instalado muchos plugins o tienes una página con mucho contenido.

¿Cómo aumentar la memoria?

Puedes hacerlo editando el archivo wp-config.php, que es el archivo de configuración principal de WordPress.

1. Ve a la raíz de tu instalación de WordPress (en public_html).
2. Busca el archivo wp-config.php.
3. Haz clic derecho y selecciona "Editar" (o "Code Editor").
4. Busca la línea que dice ¡Eso es todo, deja de editar! Feliz blogging. (o That's all, stop editing! Happy blogging.).
5. Justo antes de esa línea, pega el siguiente código:

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

Este código le dice a WordPress que puede usar hasta 256 megabytes de memoria. Es un valor seguro y muy común.

6. Guarda el archivo y comprueba tu sitio.

• Si el error desaparece: El problema era la falta de memoria. Considera si necesitas tantos plugins o si es momento de contratar un plan de hosting superior.
• Si el error persiste: Sigue adelante.

Solución 5: Verificar los permisos de archivos y carpetas

Los permisos de archivos en un servidor Linux son cruciales. Si están mal configurados, el servidor no puede leer o ejecutar los archivos, lo que resulta en un directadmin error 500.

¿Cuáles son los permisos correctos?

• Carpetas (Directorios): Deben tener permisos 755.
• Archivos: Deben tener permisos 644.

¿Cómo corregirlos en DirectAdmin?

1. En el Administrador de Archivos, selecciona todos los archivos y carpetas de tu public_html.
2. En la barra superior, busca el botón de "Permisos" (a veces es un icono de candado o un engranaje).
3. Asegúrate de que las casillas estén marcadas de la siguiente manera:
   • Propietario: Leer, Escribir, Ejecutar (marcado).
   • Grupo: Leer, Ejecutar (marcado).
   • Público: Leer, Ejecutar (marcado).
4. Haz clic en "Cambiar" o "Aplicar".

Esto cambiará los permisos de todo en masa. Después, tendrás que ajustar los archivos individualmente a 644. Selecciona solo los archivos (no carpetas) y en la opción de permisos, desmarca la casilla de "Escribir" para Grupo y Público, dejando solo "Leer". El propietario debe tener "Leer" y "Escribir".

[TIP] No es una solución elegante, pero funciona. Si no quieres hacerlo manualmente, puedes conectarte por FTP con un cliente como FileZilla, seleccionar todo y poner los permisos de forma recursiva.

Solución 6: Revisar los logs de error del servidor (La clave del misterio)

Si has llegado hasta aquí, es hora de dejar de adivinar y pasar a la evidencia. El servidor guarda un registro de todos los errores que ocurren. Ahí estará la causa exacta del error 500 en WordPress.

¿Cómo encontrar los logs en DirectAdmin?

1. En tu panel de DirectAdmin, busca la sección de "Gestión de Logs" o "Logs de Errores". Suele estar en el menú de "Estadísticas" o "Herramientas".
2. Busca el archivo llamado error.log o logs/error.log. A veces está dentro de la carpeta de tu dominio: domains/tudominio.com/logs/error.log.
3. Descarga el archivo o ábrelo en el visor de logs de DirectAdmin.
4. Busca la hora exacta en la que empezó el error. Las líneas más recientes estarán al final.
5. Busca líneas que contengan PHP Fatal error o PHP Warning. El mensaje te dirá exactamente qué archivo y en qué línea está el problema.

Por ejemplo, verás algo así:

[12-Aug-2024 10:00:00 UTC] PHP Fatal error: Uncaught Error: Call to undefined function wp_nonce_field() in /home/usuario/domains/tudominio.com/public_html/wp-content/themes/mi-tema/functions.php on line 45

Este mensaje te dice que el problema está en el tema mi-tema, en la línea 45 del archivo functions.php. Con esta información, puedes ir directamente a ese archivo y corregirlo, o simplemente desactivar el tema como hicimos en la Solución 3.

[INFO] Esta es la solución más profesional y rápida. Aprender a leer los logs te ahorrará muchísimo tiempo en el futuro.

Solución 7: Comprobar la versión de PHP

DirectAdmin te permite cambiar la versión de PHP de tu sitio fácilmente. A veces, un plugin o un tema requiere una versión más reciente de PHP, y si tu sitio está usando una versión antigua, puede lanzar un error 500.

1. En DirectAdmin, busca la opción "Select PHP Version" o "Administrador de PHP".
2. Asegúrate de que estás usando una versión de PHP que sea compatible con tu versión de WordPress. Como regla general, se recomienda usar una versión de PHP que sea al menos la 8.0 o superior.
3. Si estás usando una versión antigua (como 5.6 o 7.0), cámbiala a una más moderna (por ejemplo, 8.1 o 8.2) y guarda los cambios.
4. Comprueba tu sitio.

[WARNING] Cambiar la versión de PHP puede provocar conflictos con plugins antiguos. Si el error aparece después del cambio, vuelve a la versión anterior.

Preguntas Frecuentes (FAQ)

¿Por qué veo el error 500 solo en una página específica?

Esto suele indicar que el problema está en un plugin o función que se ejecuta solo en esa página, como un plugin de formularios de contacto o un constructor de páginas. Los logs de error te darán la pista exacta.

¿El error 500 puede ser por un ataque de hackers?

Sí, es posible. Un hacker puede inyectar código malicioso en tus archivos (como el .htaccess o los archivos de tu tema) que provoque el error. Si sospechas de esto, revisa los archivos en busca de código extraño y cambia todas tus contraseñas.

¿Debo contactar con mi proveedor de hosting?

Si has seguido todos los pasos y el error persiste, puede que el problema esté en el servidor a un nivel que no puedes controlar (por ejemplo, un problema de configuración general). En ese caso, contacta con el soporte de tu hosting y muéstrales los logs de error que has encontrado.

Conclusión

Solucionar un error 500 en WordPress en un entorno DirectAdmin puede parecer desalentador al principio, pero como has visto, es un proceso lógico de eliminación. Desde el archivo .htaccess hasta los plugins, pasando por la memoria y los permisos, cada paso te acerca más a la solución.

Recuerda siempre empezar por lo más simple (renombrar archivos) y dejar lo más técnico (leer logs) para el final si es necesario. Con un poco de paciencia y esta guía, tu sitio estará de vuelta en línea en poco tiempo. Y si en algún momento te sientes perdido, no dudes en buscar la ayuda de tu proveedor de hosting; para eso están.