Errores comunes en WordPress: Soluciones para cPanel, Plesk y DirectAdmin

¿Te has encontrado con un mensaje de error en tu web de WordPress y no sabes por dónde empezar? Tranquilo, es una situación muy común. Incluso los sitios más cuidados pueden dar algún que otro susto. La buena noticia es que la mayoría de estos errores tienen solución y, a menudo, son más fáciles de arreglar de lo que parecen.

En esta guía, vamos a desglosar los fallos más frecuentes que puedes encontrar al gestionar un WordPress alojado en paneles de control como cPanel, Plesk o DirectAdmin (e incluso en Syspanel, el nombre que usamos para HestiaCP, que se accede por el puerto 2106). Te explicaré paso a paso cómo identificar y solucionar cada problema, sin necesidad de ser un experto en programación.

Vamos a empezar por lo básico: entender qué está pasando y cómo actuar.

¿Por qué ocurren los errores en WordPress?

Antes de meter manos a la obra, es útil saber que los errores en WordPress suelen tener tres causas principales:

Conflictos entre plugins o temas: Algo no se lleva bien con algo. Es la causa más frecuente.
Límites de recursos del servidor: Tu web necesita más memoria o tiempo de proceso del que el servidor le permite.
Archivos corruptos o permisos incorrectos: Algún archivo esencial se ha dañado o no se puede leer/escribir correctamente.

Con esto en mente, atacar el problema es mucho más sencillo. Vamos a ver los errores uno por uno.

Error 500 WordPress: El Error Interno del Servidor

Este es, probablemente, el error más temido y, paradójicamente, uno de los más fáciles de solucionar. El error 500 WordPress es un mensaje genérico que indica que algo falló en el servidor, pero no nos dice exactamente qué.

¿Cómo se ve?

Una página en blanco o con el texto "Error interno del servidor" o "HTTP Error 500".

Solución paso a paso (válida para cPanel, Plesk, DirectAdmin y Syspanel)

Activa el modo de depuración de WordPress (Debug): Esto es como encender una linterna en una habitación oscura. Te mostrará el error real.
- Accede a tu panel de control (cPanel, Plesk, etc.) y busca el Administrador de Archivos.
- Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress.
- Ábrelo para editarlo. Busca la línea que dice define('WP_DEBUG', false);.
- Si no existe, añádela justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */.
- Cámbiala por esto:
```
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
```
- Guarda el archivo. Ahora, cuando recargues tu web, puede que veas un mensaje de error específico (como "Fatal error: ..."). Si no ves nada, se creará un archivo de registro llamado debug.log en la carpeta /wp-content/. Descarga ese archivo y léelo; ahí estará la pista.
Aumenta el límite de memoria de WordPress: A veces, el servidor se queda sin memoria para ejecutar un plugin.
- En el mismo archivo wp-config.php, busca la línea que define WP_MEMORY_LIMIT o añade esta línea justo antes del comentario final:
```
define('WP_MEMORY_LIMIT', '256M');
```
Desactiva todos los plugins (la solución más común): Si no puedes acceder al panel de administración, hazlo desde el panel de control.
- Ve al Administrador de Archivos.
- Navega a la carpeta /wp-content/.
- Busca la carpeta llamada plugins. No entres dentro.
- Renómbrala a plugins_old (o algo similar). Esto desactivará todos los plugins de golpe.
- Vuelve a tu web. Si el error desaparece, el problema era uno de los plugins. Ahora, renombra la carpeta a plugins de nuevo. Ve al panel de administración de WordPress (si puedes) y ve activando los plugins uno por uno hasta encontrar el culpable.

[TIP] Si renombrar la carpeta de plugins soluciona el error, pero al volver a ponerle el nombre original vuelve a fallar, tienes un plugin conflictivo. Actívalos de uno en uno desde el panel de administración para identificarlo.

Revisa los archivos .htaccess: Un archivo .htaccess dañado puede provocar un error 500.
- En el Administrador de Archivos, localiza el archivo .htaccess en la raíz de tu WordPress.
- Renómbralo a .htaccess_old.
- Vuelve a tu web. ¿Funciona? Si es así, el problema está ahí. Ve a Ajustes > Enlaces permanentes en tu panel de WordPress y haz clic en "Guardar cambios" para regenerar un .htaccess nuevo y limpio.

Pantalla Blanca de la Muerte (WSOD)

La pantalla blanca WordPress es similar al error 500, pero sin ningún mensaje. Simplemente, una página en blanco. Es igual de frustrante, pero se soluciona igual.

Solución

Sigue exactamente los mismos pasos que para el error 500 WordPress. Empieza siempre por desactivar los plugins renombrando la carpeta. Es la solución más eficaz en el 90% de los casos.

Si desactivar plugins no funciona, el siguiente paso es cambiar al tema por defecto (Twenty Twenty-Four o similar).

En el Administrador de Archivos, ve a /wp-content/themes/.
Busca la carpeta de tu tema activo y renómbrala a tu-tema_old.
WordPress automáticamente cambiará al tema por defecto. Si la web vuelve a la vida, el problema es tu tema. Puedes reinstalarlo o contactar con su desarrollador.

Error de Conexión a la Base de Datos

Este error es muy descriptivo: "Error establishing a database connection". Significa que WordPress no puede hablar con la base de datos donde guarda todo tu contenido.

¿Cómo se ve?

Un mensaje claro que dice que no se puede establecer una conexión con la base de datos.

Solución paso a paso

Verifica los datos de conexión en wp-config.php: Es el lugar más común del error.
- Abre el archivo wp-config.php desde el Administrador de Archivos.
- 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_de_datos');
define('DB_PASSWORD', 'contraseña_de_la_base_de_datos');
define('DB_HOST', 'localhost');
```
- El Host suele ser 'localhost', pero a veces tu proveedor usa otro (como 'mysql.tudominio.com'). Consúltalo en la documentación de tu hosting o en el panel de control (cPanel, Plesk, etc.) en la sección de bases de datos MySQL.
Repara la base de datos: A veces la base de datos se corrompe ligeramente.
- Añade esta línea a tu wp-config.php justo antes del comentario final:
```
define('WP_ALLOW_REPAIR', true);
```
- Guarda el archivo y visita esta URL: tudominio.com/wp-admin/maint/repair.php
- Haz clic en "Reparar base de datos".
- ¡IMPORTANTE! Una vez terminado, borra esa línea de wp-config.php. Si la dejas, cualquiera podría reparar (y dañar) tu base de datos.

[WARNING] Nunca dejes la línea define('WP_ALLOW_REPAIR', true); en tu archivo de configuración de forma permanente. Es una puerta abierta a problemas de seguridad. Bórrala inmediatamente después de usarla.

Verifica que el servidor de bases de datos esté funcionando: Esto es menos común, pero puede pasar. Si los pasos anteriores no funcionan, contacta a tu soporte de hosting y pregúntales si el servicio MySQL/MariaDB está activo en tu servidor. En paneles como cPanel, puedes verificar el estado desde la sección "MySQL Databases".

Error de Conexión a la Base de Datos al Instalar o Migrar

A veces, este error aparece específicamente durante una instalación o una migración. Si estás en ese caso, el problema suele ser que los datos de la base de datos en el archivo wp-config.php no coinciden con los que creaste en tu nuevo panel (cPanel, Plesk, DirectAdmin, Syspanel).

Solución específica para migraciones

Asegúrate de haber creado la base de datos y el usuario en el nuevo panel. En cPanel, por ejemplo, es en "MySQL Databases". En Plesk, en "Databases". En DirectAdmin, en "MySQL Management".
Asigna el usuario a la base de datos con todos los privilegios. Este es un paso que se olvida a menudo.
Copia los datos exactos (nombre de la DB, usuario y contraseña) en el archivo wp-config.php de tu nueva instalación.
Verifica el DB_HOST. Como decíamos, no siempre es localhost. En algunos hostings compartidos o en Syspanel (HestiaCP), puede ser 127.0.0.1 o una dirección IP específica. Pregunta a tu proveedor si no estás seguro.

Problemas de Permisos de Archivos

Los permisos incorrectos pueden provocar desde que no puedas subir imágenes hasta que la web se vea rara o no funcione.

¿Cómo saber si es un problema de permisos?

Suelen aparecer errores como "No se puede crear el directorio wp-content/uploads" o "Error al mover el archivo subido".

Solución

Conecta por FTP o usa el Administrador de Archivos de tu panel.
Las carpetas deben tener permisos 755 (o 750 en servidores más restrictivos).
Los archivos deben tener permisos 644 (o 640).
El archivo wp-config.php debe tener permisos 600 o 640. Es un archivo sensible.
La carpeta wp-content y todo su interior (incluyendo uploads, plugins, themes) deben ser propiedad del usuario del hosting (a menudo llamado nobody, www-data o tu nombre de usuario). Si no sabes cómo cambiar la propiedad, tu soporte técnico puede hacerlo en segundos.

[INFO] En paneles como cPanel, puedes seleccionar todos los archivos de la raíz, hacer clic derecho y seleccionar "Cambiar permisos". Marca las casillas correctas (por ejemplo, para 755: propietario: lectura, escritura, ejecución; grupo y público: lectura, ejecución). Es mucho más fácil que escribir números.

Error al Subir Imágenes (Problema de Ruta o Memoria)

Este es otro clásico. Subes una imagen y WordPress te dice que no puede.

Soluciones

Aumenta el límite de memoria: Como vimos antes, añade define('WP_MEMORY_LIMIT', '256M'); al wp-config.php.
Verifica los permisos de la carpeta uploads: La carpeta /wp-content/uploads/ y todas sus subcarpetas deben tener permisos 755. Además, el usuario del servidor web debe poder escribir en ella.
Reinstala el plugin de WordPress (si es una imagen de medios): A veces, el problema es un plugin que interfiere. Desactiva todos los plugins y vuelve a intentarlo.
Comprueba el tamaño del archivo: Algunos servidores limitan el tamaño de subida. Puedes aumentarlo editando el archivo php.ini (si tu panel lo permite) o añadiendo esto al .htaccess:
```
php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300
php_value max_input_time 300
```

Preguntas Frecuentes (FAQ)

P: ¿Cómo accedo al Administrador de Archivos en cPanel?
R: Inicia sesión en tu cPanel (normalmente tudominio.com/cpanel). Busca la sección "Archivos" y haz clic en el icono "Administrador de Archivos". Luego, navega a la carpeta public_html (o www), que es donde suele estar tu WordPress.

P: ¿Y si mi panel es Plesk?
R: En Plesk, inicia sesión y ve a "Sitios web y dominios". Busca tu dominio y haz clic en "Administrador de archivos" (a veces está en el menú de herramientas). Es muy similar.

P: ¿Qué hago si no encuentro el archivo wp-config.php?
R: El archivo wp-config.php está en la raíz de tu instalación de WordPress. Si no lo ves, asegúrate de que el Administrador de Archivos esté configurado para mostrar archivos ocultos. En cPanel, hay una casilla en la parte superior derecha que dice "Mostrar archivos ocultos (puntos)". Márcala.

P: ¿Y si uso Syspanel (HestiaCP)?
R: Perfecto. Recuerda que el acceso a Syspanel es a través del puerto 2106 (ejemplo: tudominio.com:2106). Una vez dentro, busca la sección "Archivos" o "Administrador de archivos" para tu dominio. El proceso para solucionar errores es exactamente el mismo que en los otros paneles.

P: Desactivé todos los plugins y la web funciona, ¿cómo encuentro el culpable?
R: Ve al panel de administración de WordPress (si puedes acceder). Ve a Plugins > Plugins instalados. Actívalos uno por uno. Después de activar cada uno, visita tu web. Cuando el error vuelva a aparecer, ¡ese es el plugin problemático!

P: ¿Un tema puede causar un error 500?
R: Sí, absolutamente. Si desactivar plugins no soluciona el error, el siguiente paso es cambiar al tema por defecto de WordPress. Es una causa muy común de conflictos.

Espero que esta guía detallada te haya sido de gran ayuda. La próxima vez que te enfrentes a un error 500 WordPress o a una temida pantalla blanca WordPress, ya sabes por dónde empezar. Recuerda: paciencia, sigue los pasos en orden y, sobre todo, no tengas miedo de explorar tu panel de control. ¡Tú puedes con esto!