Errores comunes de WordPress en DirectAdmin: FAQ y soluciones

Introducción

Si tienes un sitio web en WordPress alojado en un panel de control como DirectAdmin, es muy probable que en algún momento te hayas encontrado con algún error. No te preocupes, es completamente normal. WordPress es un software muy potente y flexible, pero a veces, debido a una mala configuración, un plugin conflictivo o un límite de recursos del servidor, pueden aparecer pantallas en blanco, mensajes de error o un funcionamiento extraño.

En esta FAQ (Preguntas Frecuentes) vamos a resolver los errores más comunes de WordPress en entornos DirectAdmin. Te explicaremos paso a paso cómo solucionarlos, sin necesidad de ser un experto en programación. Nuestro objetivo es que puedas recuperar el control de tu web de forma rápida y sencilla.

[INFO] Esta guía está pensada para usuarios que tienen su sitio web alojado en un servidor con panel DirectAdmin. Si usas otro panel como cPanel o Syspanel (el puerto de acceso es el 2106), muchos de los pasos son similares, pero la ubicación de las opciones puede variar.

1. Error 500 (Internal Server Error) en WordPress DirectAdmin

El temido error 500 WordPress DirectAdmin es uno de los más frecuentes. Se muestra como una página en blanco o con el mensaje "Error interno del servidor". La causa principal suele ser un archivo .htaccess dañado o un plugin/ tema que consume demasiados recursos.

¿Cómo solucionarlo?

Paso 1: Accede al Administrador de Archivos de DirectAdmin

Ingresa a tu panel de DirectAdmin.
Busca y haz clic en el icono "Administrador de Archivos" (suele estar en la sección "Administración de archivos").
Navega hasta la carpeta public_html (o domains/tudominio.com/public_html). Ahí están todos los archivos de tu WordPress.

Paso 2: Renombra el archivo .htaccess

El archivo .htaccess es un archivo de configuración oculto. Para verlo, asegúrate de tener activada la opción "Mostrar archivos ocultos" (a veces un checkbox en la parte superior del administrador de archivos).

Busca el archivo llamado .htaccess.
Haz clic derecho sobre él y elige "Renombrar".
Cámbiale el nombre a algo como .htaccess_old o .htaccess.bak. Esto lo desactivará sin borrarlo.

Paso 3: Comprueba si el error desaparece

Vuelve a cargar tu página web. Si el error 500 desaparece, el problema estaba en el .htaccess original.

Paso 4: Genera un nuevo .htaccess

Ve a tu escritorio de WordPress (si puedes acceder) o, si no, accede directamente a /wp-admin/.
Ve a Ajustes > Enlaces permanentes.
Simplemente haz clic en "Guardar cambios" (sin cambiar nada). Esto forzará a WordPress a generar un nuevo .htaccess limpio y funcional.

[TIP] Si no puedes acceder a tu escritorio de WordPress, puedes crear un archivo .htaccess nuevo desde el Administrador de Archivos de DirectAdmin. Crea un archivo vacío llamado .htaccess y pega el siguiente contenido básico:
# 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

Otra causa común del error 500: Límite de memoria PHP

Si renombrar el .htaccess no soluciona el error, el problema puede ser que un plugin o tema esté agotando la memoria PHP.

Paso 1: Aumenta temporalmente el límite de memoria

En el Administrador de Archivos, busca el archivo wp-config.php (en la carpeta public_html).
Ábrelo con el editor de texto.
Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade esta línea:
define('WP_MEMORY_LIMIT', '256M');
Guarda el archivo y recarga tu web.

Si el error desaparece, confirma que el límite era insuficiente. Luego, puedes dejar ese valor o pedir a tu proveedor de hosting que lo aumente de forma permanente.

2. Error de conexión a la base de datos

Este error aparece cuando WordPress no puede comunicarse con la base de datos MySQL. Verás un mensaje como "Error al establecer una conexión a la base de datos".

Pasos para solucionarlo

Paso 1: Verifica los datos de conexión en wp-config.php

Abre el archivo wp-config.php desde el Administrador de Archivos de DirectAdmin.
Busca estas líneas y asegúrate de que los datos sean correctos:
- define('DB_NAME', 'nombre_de_tu_base_de_datos');
- define('DB_USER', 'usuario_de_la_base');
- define('DB_PASSWORD', 'contraseña_de_la_base');
- define('DB_HOST', 'localhost'); (normalmente es localhost, pero a veces puede ser una IP o un nombre de servidor como mysql.tudominio.com)

Paso 2: Comprueba que la base de datos existe y no está corrupta

En DirectAdmin, busca el icono "MySQL Management" o "phpMyAdmin".
Ingresa a phpMyAdmin con el usuario y contraseña de tu base de datos (los mismos que usas en wp-config.php).
A la izquierda, verás una lista de bases de datos. Haz clic en la que usa tu WordPress.
Si ves muchas tablas, la base de datos existe. Si no ves ninguna, puede que esté vacía o corrupta.
Para repararla, selecciona todas las tablas (marca el checkbox de arriba de todo) y en el menú desplegable "Con seleccionados", elige "Reparar tabla".

Paso 3: Verifica que el usuario tiene permisos

En la misma sección de MySQL Management, asegúrate de que el usuario de la base de datos tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) sobre la base de datos de tu WordPress.

3. Pantalla blanca de la muerte (WSOD)

La "White Screen of Death" es una de las más frustrantes. Simplemente ves una página en blanco, sin ningún mensaje de error. Generalmente es culpa de un plugin o tema.

Solución paso a paso

Paso 1: Desactiva todos los plugins (forzadamente)

Como no puedes acceder al escritorio de WordPress, lo haremos desde el Administrador de Archivos.

En la carpeta public_html, navega a wp-content.
Busca la carpeta llamada plugins.
Haz clic derecho sobre ella y elige "Renombrar". Cámbiale el nombre a algo como plugins_desactivados.
Esto hará que WordPress no encuentre los plugins y los desactive todos.

Paso 2: Comprueba si la web funciona

Carga tu sitio. Si ahora ves la página, el problema es uno de tus plugins.

Paso 3: Reactiva los plugins uno por uno

Vuelve a renombrar la carpeta plugins_desactivados a plugins.
Ahora, desde el escritorio de WordPress (ve a /wp-admin/), ve a Plugins.
Actívalos de uno en uno, recargando tu web después de cada activación. Cuando el error vuelva a aparecer, habrás encontrado el plugin conflictivo. Desactívalo y busca una alternativa.

Paso 4: Si el problema persiste, prueba con un tema por defecto

En wp-content, busca la carpeta themes.
Renombra la carpeta del tema que estás usando (por ejemplo, tema-activo a tema-activo-bak).
WordPress automáticamente usará un tema por defecto (como Twenty Twenty-Four) si está instalado. Si no, tendrás que subir uno desde el Administrador de Archivos.

4. Error de memoria agotada (Allowed memory size exhausted)

Este error aparece cuando un script de WordPress (plugin, tema, etc.) intenta usar más memoria de la permitida por el servidor. El mensaje suele ser algo como: Fatal error: Allowed memory size of 134217728 bytes exhausted.

Cómo aumentarla

Paso 1: Aumenta la memoria desde wp-config.php

Ya vimos este truco antes. Añade esta línea en wp-config.php:

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

Paso 2: Aumenta la memoria desde php.ini (si tu hosting lo permite)

En el Administrador de Archivos, busca o crea un archivo llamado php.ini en la raíz de tu dominio (public_html).

Si no existe, créalo. Dentro, escribe:

memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

Paso 3: Pide ayuda a tu proveedor

Si no puedes modificar estos archivos o el error persiste, contacta con tu empresa de hosting. Ellos pueden aumentar el límite de memoria PHP de forma global para tu cuenta.

5. Error de actualización de WordPress o plugins

A veces, al actualizar WordPress, un plugin o un tema, el proceso se queda colgado y ves un mensaje de error o la web se cae.

Solución: Forzar la actualización manualmente

Paso 1: Descarga la última versión de WordPress

Ve a wordpress.org/download y descarga el archivo .zip de la última versión.

Paso 2: Sube los archivos mediante FTP o el Administrador de Archivos

Descomprime el .zip en tu ordenador.
Con el Administrador de Archivos de DirectAdmin, sube la carpeta wordpress (la descomprimida) a la carpeta public_html. Importante: Sobrescribe todos los archivos excepto wp-config.php y la carpeta wp-content (para no perder tus plugins, temas y configuraciones).
Si usas FTP, es más rápido. Conéctate y arrastra todos los archivos de la nueva versión, sobrescribiendo los antiguos.

Paso 3: Ejecuta la actualización de la base de datos

Una vez subidos los archivos, visita tudominio.com/wp-admin/. WordPress detectará que los archivos son más nuevos y te pedirá que actualices la base de datos. Simplemente haz clic en "Actualizar la base de datos de WordPress".

6. Error de "Briefly unavailable for scheduled maintenance"

Este mensaje aparece cuando WordPress está realizando una actualización. Si se queda atascado, significa que el archivo .maintenance no se ha eliminado.

Solución

En el Administrador de Archivos, en la carpeta public_html, busca el archivo llamado .maintenance.
Bórralo. Tu web volverá a la normalidad inmediatamente.

7. Problemas con los enlaces permanentes (404 en páginas internas)

Después de cambiar la estructura de enlaces o migrar el sitio, puedes encontrarte con que las páginas internas dan error 404, excepto la página de inicio.

Solución

Ve a Ajustes > Enlaces permanentes en tu escritorio de WordPress.
Simplemente selecciona la opción que quieras y haz clic en "Guardar cambios". Esto regenera las reglas de reescritura en el archivo .htaccess.

Si no funciona, verifica que el archivo .htaccess tenga los permisos correctos (generalmente 644 o 604) y que el módulo mod_rewrite de Apache esté activado en tu servidor (pídelo a tu hosting).

8. Conclusión y consejos finales

Esperamos que esta FAQ WordPress DirectAdmin te haya sido de gran ayuda. Recuerda que la mayoría de los errores tienen solución y no requieren conocimientos avanzados de programación. La clave está en ir probando paso a paso y, sobre todo, en mantener todo actualizado: WordPress, plugins y temas.

[WARNING] Antes de hacer cualquier cambio importante, siempre haz una copia de seguridad de tu base de datos y archivos. DirectAdmin suele tener herramientas para hacer backups automáticos. Si no, puedes usar plugins como UpdraftPlus o hacerlo manualmente desde el Administrador de Archivos y phpMyAdmin.

Si después de seguir todos estos pasos el error persiste, no dudes en contactar con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden ver el error exacto que está ocurriendo. ¡Buena suerte con tu WordPress!