Errores comunes en WordPress: soluciones desde cPanel

¿Te ha pasado alguna vez que tu web en WordPress de repente se vuelve una pantalla blanca, o te aparece el temido "Error al conectar con la base de datos"? No te preocupes, es más común de lo que crees. Como técnico de soporte, he visto estos problemas cientos de veces y, afortunadamente, la mayoría tienen solución desde el panel de control de tu hosting.

En este artículo, vamos a recorrer los errores más frecuentes de WordPress y, paso a paso, te explicaré cómo solucionarlos usando herramientas como cPanel o Syspanel (que recordemos, se accede por el puerto 2106). No necesitas ser un experto en programación; con seguir las instrucciones al pie de la letra, podrás recuperar tu sitio en pocos minutos.

Error de conexión a la base de datos

Este es, sin duda, uno de los sustos más grandes. Ves un mensaje que dice "Error al conectar con la base de datos" y tu web se vuelve inaccesible. La causa suele ser que los datos de acceso a la base de datos (nombre, usuario, contraseña) no coinciden con los que tiene configurado WordPress.

Solución paso a paso desde cPanel o Syspanel

Accede a tu panel de control. Puede ser cPanel (puerto 2083) o Syspanel (puerto 2106). Busca la sección "Archivos" o "Administrador de archivos".
Dentro del administrador de archivos, navega hasta la carpeta raíz de tu sitio web. Normalmente se llama public_html o htdocs.
Busca el archivo wp-config.php. Es el archivo de configuración principal de WordPress. Haz clic derecho sobre él y selecciona "Editar" o "Modificar".

Localiza las siguientes líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');

Verifica que estos datos sean correctos. Si no los recuerdas, puedes crear una nueva base de datos desde tu panel. Ve a "Bases de datos" -> "MySQL Databases" (en cPanel) o "Base de datos" -> "Crear base de datos" (en Syspanel).
Crea una nueva base de datos, un nuevo usuario y asigna el usuario a la base de datos con todos los privilegios. Anota los datos.
Vuelve al archivo wp-config.php y reemplaza los valores antiguos por los nuevos.
Guarda los cambios y cierra el archivo. Refresca tu web y el error debería desaparecer.

[INFO] Si el error persiste, revisa que el servidor de base de datos (DB_HOST) no sea diferente a "localhost". Algunos hosting usan direcciones como "mysql.nombredehost.com". Puedes consultar este dato en la sección de bases de datos de tu panel.

Pantalla blanca de la muerte (WSOD)

La temida pantalla blanca. No muestra ningún mensaje, solo un fondo en blanco. Esto suele deberse a un plugin o tema defectuoso, o a un límite de memoria de PHP agotado.

Solución: Desactivar plugins y temas desde el panel

Como no puedes acceder al escritorio de WordPress, lo haremos desde el administrador de archivos.

Accede a tu panel de control (cPanel o Syspanel) y abre el "Administrador de archivos".
Ve a la carpeta public_html y luego a wp-content.
Para desactivar todos los plugins: Dentro de wp-content, verás una carpeta llamada plugins. Cámbiale el nombre a plugins_desactivados. Esto hará que WordPress no encuentre los plugins y los desactive automáticamente.
Refresca tu web. Si el error desaparece, el problema está en uno de los plugins.
Para identificar el plugin problemático: Vuelve a cambiar el nombre de la carpeta a plugins. Luego, dentro de ella, ve renombrando cada carpeta de plugin individualmente (por ejemplo, akismet_desactivado) y refrescando la web hasta que el error desaparezca. El último que renombraste es el culpable.
Para temas: Si el error persiste, el problema puede ser del tema. Dentro de wp-content, busca la carpeta themes. Cambia el nombre de la carpeta de tu tema activo (por ejemplo, tema_activo_desactivado). WordPress cargará un tema por defecto (Twenty Twenty-Four). Si la web funciona, el tema tiene un error.

[WARNING] Si renombras la carpeta de tu tema activo, perderás la personalización visual. Pero es la forma más segura de diagnosticar.

Aumentar el límite de memoria de PHP

Otra causa común de la pantalla blanca es quedarse sin memoria. Puedes aumentarla desde el archivo wp-config.php.

Abre el archivo wp-config.php desde el administrador de archivos.
Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! */, añade esta línea:
```
define('WP_MEMORY_LIMIT', '256M');
```
Guarda los cambios. Esto le da a WordPress 256 MB de memoria, suficiente para la mayoría de los sitios.

Error 500: Internal Server Error

Este error es genérico y puede tener muchas causas: un archivo .htaccess corrupto, un plugin que hace peticiones infinitas, o problemas de permisos.

Solución: Regenerar el archivo .htaccess

Desde el administrador de archivos, ve a la carpeta raíz de tu web (public_html).
Busca el archivo .htaccess (puede estar oculto; activa la opción "Mostrar archivos ocultos" en la configuración del administrador).
Haz clic derecho y renómbralo a .htaccess_viejo. Esto lo desactiva temporalmente.
Refresca tu web. Si el error desaparece, el archivo .htaccess original estaba dañado.
Para crear uno nuevo, ve a "Ajustes" -> "Enlaces permanentes" en tu escritorio de WordPress (si puedes acceder) y haz clic en "Guardar cambios". WordPress generará un nuevo .htaccess limpio.

Si no puedes acceder al escritorio, puedes crear un archivo .htaccess básico desde el administrador de archivos. Crea un nuevo archivo, pégalo y guárdalo:

# 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

[TIP] Si el error persiste después de esto, revisa los permisos de archivos y carpetas. Los archivos deben tener permiso 644 y las carpetas 755. Puedes cambiarlos desde el administrador de archivos seleccionando todo y usando la opción "Cambiar permisos".

Error 404 después de cambiar enlaces permanentes

Es muy común que al cambiar la estructura de las URLs (por ejemplo, a "Nombre de la entrada"), las páginas internas devuelvan un error 404. La solución es sencilla.

Solución: Actualizar los enlaces permanentes

Accede a tu escritorio de WordPress.
Ve a "Ajustes" -> "Enlaces permanentes".
Simplemente selecciona la opción que quieras (por ejemplo, "Nombre de la entrada") y haz clic en "Guardar cambios".
WordPress regenerará las reglas de reescritura. Refresca cualquier página interna y el error 404 debería desaparecer.

Si no puedes acceder al escritorio, puedes forzar la regeneración editando el archivo .htaccess como vimos en el error 500, o temporalmente cambiando a la opción "Simple" desde la base de datos (no recomendado si no sabes hacerlo).

Error "Se ha excedido el límite de memoria permitido"

Este mensaje suele aparecer en la parte superior del escritorio de WordPress o en los logs del servidor. Indica que un script está consumiendo más memoria de la asignada.

Solución: Aumentar la memoria desde wp-config.php o php.ini

Ya vimos cómo aumentar la memoria desde wp-config.php. Otra opción es crear o modificar un archivo php.ini en la raíz de tu web.

Desde el administrador de archivos, crea un nuevo archivo llamado php.ini en public_html.

Pega el siguiente contenido:

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

Guarda el archivo. Si tu hosting usa PHP como módulo de Apache, estos cambios se aplicarán.

[INFO] Si tu hosting usa PHP-FPM, es posible que necesites editar un archivo llamado .user.ini en lugar de php.ini. Consulta con tu proveedor de hosting si no estás seguro.

Error al subir imágenes o archivos

A veces, al intentar subir una imagen, WordPress dice "Error al subir el archivo" o "El archivo no se ha podido subir". Esto suele deberse a límites de tamaño o permisos.

Solución: Aumentar límites y corregir permisos

Aumentar límites: Sigue los pasos del error anterior para aumentar upload_max_filesize en php.ini o wp-config.php.
Verificar permisos: La carpeta wp-content/uploads debe tener permisos 755. Desde el administrador de archivos, navega a wp-content, haz clic derecho en uploads y selecciona "Cambiar permisos". Asegúrate de que sea 755 y que esté marcada la opción "Recursivamente" para que se aplique a todas las subcarpetas.
Comprobar espacio en disco: Si tu hosting tiene espacio limitado, puede que no quede sitio. Revisa en la sección de estadísticas de tu panel de control.

Preguntas frecuentes (FAQ)

¿Qué hago si no recuerdo mi contraseña de la base de datos?

Puedes cambiarla desde tu panel de control. En cPanel, ve a "Bases de datos" -> "MySQL Databases". Busca el usuario, haz clic en "Cambiar contraseña" y elige una nueva. Luego, actualiza el archivo wp-config.php con la nueva contraseña.

¿Es seguro editar archivos desde el administrador de archivos?

Sí, siempre que tengas cuidado de no eliminar o modificar archivos importantes sin saber lo que haces. Siempre es buena idea hacer una copia de seguridad antes de hacer cambios drásticos.

¿Puedo dañar mi web si cambio el nombre de la carpeta de plugins?

No, es una técnica segura de diagnóstico. Simplemente desactiva los plugins temporalmente. Al volver a poner el nombre original, todo vuelve a la normalidad.

¿Qué es el puerto 2106 en Syspanel?

Es el puerto estándar para acceder al panel de control Syspanel (antes conocido como HestiaCP). Lo usas igual que cPanel, pero escribiendo en tu navegador: https://tudominio.com:2106.

Conclusión

Como has visto, la mayoría de los errores comunes de WordPress se pueden solucionar desde el panel de control de tu hosting, ya sea cPanel o Syspanel. No necesitas ser un hacker ni un desarrollador; con un poco de paciencia y siguiendo estos pasos, podrás resolver problemas como la pantalla blanca, el error de base de datos o los errores 500.

Recuerda siempre hacer una copia de seguridad de tu sitio antes de hacer cambios importantes. Y si en algún momento te sientes perdido, no dudes en contactar al soporte técnico de tu hosting; para eso estamos. ¡Espero que este artículo te haya sido de gran ayuda!